初始化本地仓库

This commit is contained in:
2026-08-31 11:33:59 +08:00
commit 663f74b633
2390 changed files with 402918 additions and 0 deletions
+104
View File
@@ -0,0 +1,104 @@
<?php
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: http://www.madong.tech
*/
namespace app\api\controller;
use core\base\BaseController;
use core\tool\Json;
use madong\helper\Tree;
/**
* 基类控制器继承的类
*
* @author Mr.April
* @since 1.0
*/
class Base extends BaseController
{
/**
* 初始化
*/
protected function initialize(): void
{
}
/**
* 格式化树
*
* @param $items
*
* @return \support\Response
*/
protected function formatTree($items): \support\Response
{
$format_items = [];
foreach ($items as $item) {
$format_items[] = [
'name' => $item->title ?? $item->name ?? $item->id,
'value' => (string)$item->id,
'id' => $item->id,
'pid' => $item->pid,
];
}
$tree = new Tree($format_items);
return Json::success('ok', $tree->getTree());
}
/**
* 格式化表格树
*
* @param $data
* @param $total
*
* @return \support\Response
*/
protected function formatTableTree($data, $total): \support\Response
{
$tree = new Tree($data->toArray());
$items = $tree->getTree();
return Json::success('ok', $items);
}
/**
* 格式化下拉列表
*
* @param $items
*
* @return \support\Response
*/
protected function formatSelect($items): \support\Response
{
$formatted_items = [];
foreach ($items as $item) {
$formatted_items[] = [
'label' => $item->title ?? $item->name ?? $item->real_name ?? $item->id,
'value' => $item->id,
];
}
return Json::success('ok', $formatted_items);
}
/**
* 通用格式化
*
* @param $items
* @param $total
*
* @return \support\Response
*/
protected function formatNormal($items, $total): \support\Response
{
return Json::success('ok', compact('items', 'total'));
}
}
@@ -0,0 +1,358 @@
<?php
declare(strict_types=1);
namespace app\api\controller\auth;
use app\api\controller\Base;
use app\api\validate\auth\LoginValidate;
use app\api\validate\auth\RegisterValidate;
use app\service\api\auth\AuthService;
use core\captcha\Captcha;
use core\tool\Json;
use Exception;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Container;
use Webman\Http\Request;
use Webman\Http\Response;
/**
* 认证控制器
*/
#[OA\Tag(name: '认证模块')]
final class AuthController extends Base
{
public function __construct(AuthService $service)
{
$this->service = $service;
}
#[OA\Post(
path: '/auth/login',
summary: '用户登录',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['username', 'password'],
properties: [
new OA\Property(property: 'username', description: '用户名/手机号/邮箱', type: 'string'),
new OA\Property(property: 'password', description: '密码', type: 'string'),
new OA\Property(property: 'captcha', description: '验证码', type: 'string'),
]
)
),
tags: ['认证'],
responses: [
new OA\Response(response: 200, description: '登录成功'),
new OA\Response(response: 400, description: '参数错误'),
new OA\Response(response: 401, description: '登录失败'),
]
)]
#[SimpleResponse(schema: [], example: ['token' => 'string'])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function login(Request $request): Response
{
try {
/** @var LoginValidate $validate */
$validate = Container::make(LoginValidate::class);
if (!$validate->scene('login')->check($request->post())) {
throw new Exception($validate->getError());
}
$data = $request->all();
$result = $this->service->login($data);
return Json::success($result);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 手机验证码登录
*/
#[OA\Post(
path: '/auth/login/mobile',
summary: '手机验证码登录',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['mobile', 'code'],
properties: [
new OA\Property(property: 'mobile', description: '手机号', type: 'string'),
new OA\Property(property: 'code', description: '验证码', type: 'string'),
]
)
),
tags: ['认证'],
)]
#[SimpleResponse(schema: [], example: ['token' => 'string'])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function loginWithMobile(Request $request): Response
{
$data = $request->post();
$result = $this->service->loginWithMobile($data);
return Json::success($result);
}
/**
* 用户退出登录
*/
#[OA\Post(
path: '/auth/logout',
summary: '用户退出登录',
tags: ['认证'],
responses: [
new OA\Response(response: 200, description: '退出成功'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
/** @Route(methods=["POST"], path="/auth/logout") */
public function logout(): Response
{
$result = $this->service->logout();
return Json::success($result);
}
/**
* 用户注册
*/
#[OA\Post(
path: '/auth/register',
summary: '用户注册',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['username', 'password'],
properties: [
new OA\Property(property: 'username', description: '用户名', type: 'string'),
new OA\Property(property: 'password', description: '密码', type: 'string'),
new OA\Property(property: 'email', description: '邮箱', type: 'string'),
new OA\Property(property: 'mobile', description: '手机号', type: 'string'),
new OA\Property(property: 'pid', description: '推荐人ID', type: 'integer'),
]
)
),
tags: ['认证'],
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function register(Request $request): Response
{
try {
$validate = Container::make(RegisterValidate::class);
if (!$validate->scene('register')->check($request->post())) {
throw new Exception($validate->getError());
}
$captcha = Container::make(Captcha::class);
if (!$captcha->check($request->input('captcha_key', ''), $request->input('captcha_code', ''))) {
throw new Exception('验证码错误');
}
$data = $request->all();
$result = $this->service->register($data);
return Json::success($result);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 手机号注册
*/
#[OA\Post(
path: '/auth/register/mobile',
summary: '手机号注册',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['mobile', 'code', 'password'],
properties: [
new OA\Property(property: 'mobile', description: '手机号', type: 'string'),
new OA\Property(property: 'code', description: '验证码', type: 'string'),
new OA\Property(property: 'password', description: '密码', type: 'string'),
new OA\Property(property: 'pid', description: '推荐人ID', type: 'integer'),
]
)
),
tags: ['认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function registerWithMobile(Request $request): Response
{
try {
$data = $request->post();
$result = $this->service->registerWithMobile($data);
return Json::success($result);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 绑定手机号
*/
#[OA\Post(
path: '/auth/bind',
summary: '绑定手机号',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['mobile', 'code'],
properties: [
new OA\Property(property: 'mobile', description: '手机号', type: 'string'),
new OA\Property(property: 'code', description: '验证码', type: 'string'),
new OA\Property(property: 'pid', description: '推荐人ID', type: 'integer'),
]
)
),
tags: ['认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function bindMobile(Request $request): Response
{
$data = $request->post();
$result = $this->service->bindMobile($data);
return Json::success($result);
}
/**
* 验证邮箱和验证码(忘记密码第一步)
*/
#[OA\Post(
path: '/auth/verify-email',
summary: '验证邮箱和验证码',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['email', 'code', 'captcha_key'],
properties: [
new OA\Property(property: 'email', description: '邮箱地址', type: 'string'),
new OA\Property(property: 'code', description: '邮箱验证码', type: 'string'),
new OA\Property(property: 'captcha_key', description: '验证码key', type: 'string'),
]
)
),
tags: ['认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function verifyEmail(Request $request): Response
{
try {
$data = $request->post();
$result = $this->service->verifyEmail($data);
return Json::success($result);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 发送邮箱验证码
*/
#[OA\Post(
path: '/auth/send-email-code',
summary: '发送邮箱验证码',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['email', 'captcha_key', 'captcha_code'],
properties: [
new OA\Property(property: 'email', description: '邮箱地址', type: 'string'),
new OA\Property(property: 'captcha_key', description: '图片验证码key', type: 'string'),
new OA\Property(property: 'captcha_code', description: '图片验证码', type: 'string'),
]
)
),
tags: ['认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function sendEmailCode(Request $request): Response
{
try {
$email = $request->post('email');
$captchaKey = $request->post('captcha_key');
$captchaCode = $request->post('captcha_code');
// 验证图片验证码
if (empty($captchaKey) || empty($captchaCode)) {
throw new Exception('图片验证码不能为空', 400);
}
$captcha = new Captcha();
if (!$captcha->check($captchaKey, $captchaCode)) {
throw new Exception('图片验证码错误', 400);
}
$this->service->sendEmailCode($email);
return Json::success('success', []);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 重置密码(忘记密码第二步)
*/
#[OA\Post(
path: '/auth/forget-password',
summary: '重置密码',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['email', 'code', 'new_password'],
properties: [
new OA\Property(property: 'email', description: '邮箱地址', type: 'string'),
new OA\Property(property: 'code', description: '邮箱验证码', type: 'string'),
new OA\Property(property: 'new_password', description: '新密码', type: 'string'),
new OA\Property(property: 'confirm_password', description: '确认密码', type: 'string'),
]
)
),
tags: ['认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function forgetPassword(Request $request): Response
{
try {
$data = $request->post();
$this->service->forgetPassword($data);
return Json::success('操作成功', []);
} catch (Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 刷新 token
*/
#[OA\Post(
path: '/auth/refresh',
summary: '刷新 token',
tags: ['认证'],
responses: [
new OA\Response(response: 200, description: '刷新成功'),
new OA\Response(response: 401, description: '刷新失败'),
]
)]
#[SimpleResponse(schema: [], example: ['access_token' => 'string', 'refresh_token' => 'string'])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function refresh(): Response
{
try {
$jwt = new \core\jwt\JwtToken();
$token = $jwt->refresh();
return Json::success('ok', [
'access_token' => $token->accessToken,
'refresh_token' => $token->refreshToken,
]);
} catch (\Throwable $e) {
return Json::fail($e->getMessage(), [], 401);
}
}
}
@@ -0,0 +1,273 @@
<?php
declare(strict_types=1);
namespace app\api\controller\auth;
use app\api\controller\Base;
use app\api\validate\auth\ThirdPartyAuthValidate;
use app\service\api\auth\ThirdPartyAuthService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use support\Request;
use support\Response;
/**
* 第三方认证控制器
*/
class ThirdPartyAuthController extends Base
{
public function __construct(ThirdPartyAuthService $service, ThirdPartyAuthValidate $validate)
{
$this->service = $service;
$this->validate = $validate;
}
#[\OpenApi\Attributes\Get(
path: '/auth/qq/callback',
summary: 'QQ回调',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'scene', description: '场景ID', in: 'query', required: true),
new \OpenApi\Attributes\Parameter(name: 'code', description: '授权码', in: 'query', required: true),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function qqCallback(Request $request): Response
{
try {
$scene = $request->input('scene');
$code = $request->input('code');
if (empty($scene) || empty($code)) {
throw new \Exception('参数错误', 400);
}
$this->service->handleQqCallback($scene, $code);
return Json::success('绑定成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Get(
path: '/auth/wechat/callback',
summary: '微信回调',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'scene', description: '场景ID', in: 'query', required: true),
new \OpenApi\Attributes\Parameter(name: 'code', description: '授权码', in: 'query', required: true),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function wechatCallback(Request $request): Response
{
try {
$scene = $request->input('scene');
$code = $request->input('code');
if (empty($scene) || empty($code)) {
throw new \Exception('参数错误', 400);
}
$this->service->handleWechatCallback($scene, $code);
return Json::success('绑定成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Get(
path: '/auth/weibo/callback',
summary: '微博回调',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'scene', description: '场景ID', in: 'query', required: true),
new \OpenApi\Attributes\Parameter(name: 'code', description: '授权码', in: 'query', required: true),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function weiboCallback(Request $request): Response
{
try {
$scene = $request->input('scene');
$code = $request->input('code');
if (empty($scene) || empty($code)) {
throw new \Exception('参数错误', 400);
}
$this->service->handleWeiboCallback($scene, $code);
return Json::success('绑定成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Get(
path: '/auth/douyin/callback',
summary: '抖音回调',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'scene', description: '场景ID', in: 'query', required: true),
new \OpenApi\Attributes\Parameter(name: 'code', description: '授权码', in: 'query', required: true),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function douyinCallback(Request $request): Response
{
try {
$scene = $request->input('scene');
$code = $request->input('code');
if (empty($scene) || empty($code)) {
throw new \Exception('参数错误', 400);
}
$this->service->handleDouyinCallback($scene, $code);
return Json::success('绑定成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Get(
path: '/auth/third-party/list',
summary: '获取第三方绑定列表',
tags: ['第三方认证'],
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getThirdPartyList(): Response
{
try {
$result = $this->service->getThirdPartyList();
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Post(
path: '/auth/third-party/bind',
summary: '绑定第三方账号',
requestBody: new \OpenApi\Attributes\RequestBody(
required: true,
content: new \OpenApi\Attributes\MediaType(
mediaType: 'application/json',
schema: new \OpenApi\Attributes\Schema(
properties: [
new \OpenApi\Attributes\Property(property: 'platform', description: '平台类型', type: 'integer'),
new \OpenApi\Attributes\Property(property: 'openid', description: 'OpenID', type: 'string'),
new \OpenApi\Attributes\Property(property: 'unionid', description: 'UnionID', type: 'string'),
new \OpenApi\Attributes\Property(property: 'nickname', description: '昵称', type: 'string'),
new \OpenApi\Attributes\Property(property: 'avatar', description: '头像', type: 'string'),
new \OpenApi\Attributes\Property(property: 'gender', description: '性别', type: 'integer'),
new \OpenApi\Attributes\Property(property: 'country', description: '国家', type: 'string'),
new \OpenApi\Attributes\Property(property: 'province', description: '省份', type: 'string'),
new \OpenApi\Attributes\Property(property: 'city', description: '城市', type: 'string'),
new \OpenApi\Attributes\Property(property: 'access_token', description: '访问令牌', type: 'string'),
new \OpenApi\Attributes\Property(property: 'refresh_token', description: '刷新令牌', type: 'string'),
]
)
)
),
tags: ['第三方认证']
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function bindThirdParty(Request $request): Response
{
try {
$validate = new ThirdPartyAuthValidate();
$data = $request->all();
if (!$validate->scene('bind')->check($data)) {
throw new \Exception($validate->getError());
};
$this->service->bindThirdParty($data);
return Json::success('绑定成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Delete(
path: '/auth/third-party/unbind/{platform}',
summary: '解绑第三方账号',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'platform', description: '平台类型', in: 'path', required: true),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function unbindThirdParty(Request $request, int $platform): Response
{
try {
$this->service->unbindThirdParty($platform);
return Json::success('解绑成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Post(
path: '/auth/third-party/qr-code',
summary: '生成第三方绑定二维码',
requestBody: new \OpenApi\Attributes\RequestBody(
required: true,
content: new \OpenApi\Attributes\MediaType(
mediaType: 'application/json',
schema: new \OpenApi\Attributes\Schema(
properties: [
new \OpenApi\Attributes\Property(property: 'platform', description: '平台类型', type: 'integer'),
]
)
)
),
tags: ['第三方认证'],
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function generateBindQrCode(Request $request): Response
{
try {
$platform = $request->post('platform');
if (empty($platform)) {
throw new \Exception('平台类型不能为空', 400);
}
$result = $this->service->generateBindQrCode(['platform' => $platform]);
return Json::success('生成成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[\OpenApi\Attributes\Get(
path: '/auth/third-party/qr-status',
summary: '检查绑定二维码状态',
tags: ['第三方认证'],
parameters: [
new \OpenApi\Attributes\Parameter(name: 'scene_id', description: '场景ID', in: 'query', required: true),
],
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function checkBindQrStatus(Request $request): Response
{
try {
$sceneId = $request->input('scene_id');
if (empty($sceneId)) {
throw new \Exception('场景ID不能为空', 400);
}
$result = $this->service->checkBindQrStatus($sceneId);
return Json::success('检查成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
}
@@ -0,0 +1,137 @@
<?php
declare(strict_types=1);
namespace app\api\controller\auth;
use app\api\controller\Base;
use app\service\api\auth\WechatService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use Webman\Http\Request;
use Webman\Http\Response;
#[OA\Tag(name: '微信认证')]
final class WechatController extends Base
{
public function __construct(WechatService $service)
{
$this->service = $service;
}
#[OA\Post(
path: '/auth/wechat',
summary: '微信授权登录',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['code'],
properties: [
new OA\Property(property: 'code', description: '微信授权码', type: 'string'),
new OA\Property(property: 'encrypted_data', description: '加密数据', type: 'string'),
new OA\Property(property: 'iv', description: '加密向量', type: 'string'),
]
)
),
tags: ['微信认证'],
responses: [
new OA\Response(response: 200, description: '登录成功'),
new OA\Response(response: 400, description: '参数错误'),
new OA\Response(response: 401, description: '登录失败'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function wechatLogin(Request $request): Response
{
$data = $request->post();
$result = $this->service->wechatLogin($data);
return json($result);
}
#[OA\Post(
path: '/auth/weapp',
summary: '微信小程序登录',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['code'],
properties: [
new OA\Property(property: 'code', description: '小程序登录code', type: 'string'),
new OA\Property(property: 'encrypted_data', description: '加密数据', type: 'string'),
new OA\Property(property: 'iv', description: '加密向量', type: 'string'),
]
)
),
tags: ['微信认证'],
responses: [
new OA\Response(response: 200, description: '登录成功'),
new OA\Response(response: 400, description: '参数错误'),
new OA\Response(response: 401, description: '登录失败'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function weappLogin(Request $request): Response
{
$data = $request->post();
$result = $this->service->weappLogin($data);
return json($result);
}
#[OA\Post(
path: '/auth/wechat/scan',
summary: '生成微信扫码登录二维码',
tags: ['微信认证']
)]
#[SimpleResponse(schema: [], example: [])]
public function generateWechatQrCode(): Response
{
$result = $this->service->generateWechatQrCode();
return Json::success($result);
}
/**
* 检查微信扫码状态
*/
#[OA\Get(
path: '/auth/wechat/scan/status',
summary: '检查微信扫码状态',
tags: ['微信认证'],
parameters: [
new OA\Parameter(name: 'scene_id', description: '场景ID', in: 'query', required: true, schema: new OA\Schema(type: 'string')),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function checkWechatScanStatus(Request $request): Response
{
try {
$sceneId = $request->input('scene_id');
if (empty($sceneId)) {
return Json::fail('scene_id 不能为空');
}
$result = $this->service->checkWechatScanStatus($sceneId);
return Json::success($result['msg'], $result['data']);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Get(
path: '/auth/wechat/availability',
summary: '检查微信登录可用性',
tags: ['微信认证'],
responses: [
new OA\Response(response: 200, description: '查询成功'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function checkWechatAvailability(): Response
{
$result = $this->service->checkWechatAvailability();
return Json::success('ok', $result);
}
}
@@ -0,0 +1,335 @@
<?php
declare(strict_types=1);
namespace app\api\controller\member;
use app\api\controller\Base;
use app\api\CurrentMember;
use app\api\event\MemberInfoFetchedEvent;
use app\service\api\member\MemberService;
use core\exception\handler\UnauthorizedHttpException;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Container;
use Webman\Http\Request;
use Webman\Http\Response;
use Webman\Http\UploadFile as WebmanUploadFile;
/**
* 会员用户控制器
*/
#[OA\Tag(name: '会员模块')]
final class MemberController extends Base
{
public function __construct(MemberService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/member/user-info',
summary: '获取会员基本信息',
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getProfile(): Response
{
try {
/** @var CurrentMember $currentMember */
$currentMember = Container::make(CurrentMember::class);
$data = $currentMember->user(true);
if (empty($data)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$permissions = [];
$extra = [];
$event = new MemberInfoFetchedEvent($data['id'], $data, $permissions, $extra);
$event->dispatch();
// 将修改后的数据回写到原变量
$data['permissions'] = $event->getPermissions();
if (!empty($event->getExtra())) {
$data = array_merge($data, $event->getExtra());
}
return Json::success('ok', $data);
} catch (\Throwable $e) {
return Json::fail($e->getMessage(), null, 401);
}
}
#[OA\Put(
path: '/member/user/update',
summary: '更新会员信息',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
properties: [
new OA\Property(property: 'nickname', description: '昵称', type: 'string'),
new OA\Property(property: 'avatar', description: '头像', type: 'string'),
new OA\Property(property: 'gender', description: '性别', type: 'integer'),
new OA\Property(property: 'birthday', description: '生日', type: 'string'),
]
)
),
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '更新成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function update(Request $request): Response
{
try {
$data = $request->all();
$this->service->updateInfo($data);
return Json::success();
} catch (\Exception $exception) {
return Json::fail($exception->getMessage());
}
}
#[OA\Post(
path: '/member/user/avatar',
summary: '上传头像',
requestBody: new OA\RequestBody(
required: true,
content: new OA\MediaType(
mediaType: 'multipart/form-data',
schema: new OA\Schema(
properties: [
new OA\Property(
property: 'file',
description: '头像文件',
type: 'string',
format: 'binary'
),
]
)
)
),
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '上传成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function uploadAvatar(Request $request): Response
{
try {
$file = $request->file('file');
if (!$file || !$file instanceof WebmanUploadFile) {
throw new \Exception('请上传头像文件', 400);
}
$result = $this->service->uploadAvatar($file);
return Json::success('上传成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[OA\Put(
path: '/member/user/bind-phone',
summary: '绑定会员手机号',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['phone', 'verify_code'],
properties: [
new OA\Property(property: 'phone', description: '手机号', type: 'string'),
new OA\Property(property: 'verify_code', description: '验证码', type: 'string'),
]
)
),
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '绑定成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function bindPhone(Request $request): Response
{
$data = $request->post();
$result = $this->service->bindPhone($data);
return json($result);
}
#[OA\Put(
path: '/member/user/change-password',
summary: '修改密码',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['old_password', 'new_password'],
properties: [
new OA\Property(property: 'old_password', description: '旧密码', type: 'string'),
new OA\Property(property: 'new_password', description: '新密码', type: 'string'),
]
)
),
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '修改成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function changePassword(Request $request): Response
{
try {
$data = $request->all();
$this->service->changePassword($data);
return Json::success('密码修改成功');
} catch (\Exception $e) {
return Json::fail($e->getMessage(), [], $e->getCode() ?: -1);
}
}
#[OA\Get(
path: '/member/user/address/list',
summary: '获取地址列表',
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getAddressList(): Response
{
try {
$result = $this->service->getAddressList();
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/member/user/address/create',
summary: '创建地址',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['name', 'phone', 'province', 'city', 'district', 'address'],
properties: [
new OA\Property(property: 'name', description: '收件人姓名', type: 'string'),
new OA\Property(property: 'phone', description: '手机号', type: 'string'),
new OA\Property(property: 'province', description: '省份', type: 'string'),
new OA\Property(property: 'city', description: '城市', type: 'string'),
new OA\Property(property: 'district', description: '区域', type: 'string'),
new OA\Property(property: 'address', description: '详细地址', type: 'string'),
new OA\Property(property: 'is_default', description: '是否默认地址', type: 'boolean'),
]
)
),
tags: ['会员模块'],
responses: [
new OA\Response(response: 200, description: '创建成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function createAddress(Request $request): Response
{
try {
$data = $request->post();
$result = $this->service->createAddress($data);
return Json::success('创建成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Put(
path: '/member/user/address/update/{id}',
summary: '更新地址',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
properties: [
new OA\Property(property: 'name', description: '收件人姓名', type: 'string'),
new OA\Property(property: 'phone', description: '手机号', type: 'string'),
new OA\Property(property: 'province', description: '省份', type: 'string'),
new OA\Property(property: 'city', description: '城市', type: 'string'),
new OA\Property(property: 'district', description: '区域', type: 'string'),
new OA\Property(property: 'address', description: '详细地址', type: 'string'),
new OA\Property(property: 'is_default', description: '是否默认地址', type: 'boolean'),
]
)
),
tags: ['会员模块'],
parameters: [
new OA\Parameter(name: 'id', description: '地址ID', in: 'path', required: true, schema: new OA\Schema(type: 'integer')),
],
responses: [
new OA\Response(response: 200, description: '更新成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '参数错误'),
new OA\Response(response: 404, description: '地址不存在'),
]
)]
#[SimpleResponse(schema: [], example: [])]
public function updateAddress(int $id, Request $request): Response
{
try {
$data = $request->post();
$result = $this->service->updateAddress($id, $data);
return Json::success('更新成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Delete(
path: '/member/user/address/delete/{id}',
summary: '删除地址',
tags: ['会员模块'],
parameters: [
new OA\Parameter(name: 'id', description: '地址ID', in: 'path', required: true, schema: new OA\Schema(type: 'integer')),
],
responses: [
new OA\Response(response: 200, description: '删除成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 404, description: '地址不存在'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: true, requirePermission: false, description: '公共接口')]
public function deleteAddress(int $id): Response
{
try {
$result = $this->service->deleteAddress($id);
return Json::success('删除成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,148 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: https://madong.tech
*/
namespace app\api\controller\member;
use app\api\controller\Base;
use app\api\CurrentMember;
use app\service\api\member\MemberPointsService;
use core\exception\handler\UnauthorizedHttpException;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Container;
use Webman\Http\Request;
use Webman\Http\Response;
#[OA\Tag(name: '积分模块')]
#
final class MemberPointsController extends Base
{
public function __construct(MemberPointsService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/member/points/record',
summary: '获取积分流水记录',
tags: ['积分模块'],
parameters: [
new OA\Parameter(name: 'page', description: '页码', in: 'query', schema: new OA\Schema(type: 'integer')),
new OA\Parameter(name: 'limit', description: '每页数量', in: 'query', schema: new OA\Schema(type: 'integer')),
new OA\Parameter(name: 'type', description: '积分类型', in: 'query', schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function record(Request $request): Response
{
$params = $request->all();
try {
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$params['member_id'] = $member['id'];
$result = $this->service->getPointsRecord($params);
return Json::success($result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), []);
}
}
#[OA\Get(
path: '/member/points/total',
summary: '获取会员积分总额',
tags: ['积分模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function total(): Response
{
try {
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$result = $this->service->getPointsTotal($member['id']);
return Json::success($result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), []);
}
}
#[OA\Get(
path: '/member/points/level',
summary: '获取会员等级信息',
tags: ['积分模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getMemberLevel(): Response
{
try {
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$result = $this->service->getMemberLevel($member['id']);
return Json::success($result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), []);
}
}
#[OA\Post(
path: '/member/points/sign',
summary: '会员签到',
tags: ['积分模块'],
responses: [
new OA\Response(response: 200, description: '签到成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '今日已签到'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function memberSign(): Response
{
try {
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$result = $this->service->memberSign($member['id']);
return Json::success($result);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), []);
}
}
}
@@ -0,0 +1,197 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: https://madong.tech
*/
namespace app\api\controller\member;
use app\api\controller\Base;
use app\api\CurrentMember;
use app\api\middleware\ApiAccessTokenMiddleware;
use app\service\api\member\MemberSignService;
use core\exception\handler\UnauthorizedHttpException;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\annotation\Middleware;
use support\Container;
use Webman\Http\Request;
use Webman\Http\Response;
#[OA\Tag(name: '会员签到')]
#[Middleware(ApiAccessTokenMiddleware::class)]
final class MemberSignController extends Base
{
public function __construct(MemberSignService $service)
{
$this->service = $service;
}
#[OA\Post(
path: '/member/sign',
summary: '每日签到',
tags: ['会员签到'],
responses: [
new OA\Response(response: 200, description: '签到成功'),
new OA\Response(response: 401, description: '未登录'),
new OA\Response(response: 400, description: '今日已签到'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function sign(): Response
{
try {
/** @var CurrentMember $currentMember */
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$memberId = $member['id'];
// 记录设备信息
$deviceInfo = [
'ip' => request()->getRealIp(),
'ua' => request()->header('user-agent'),
];
// 调用服务层执行签到
$result = $this->service->sign($memberId, $deviceInfo);
return Json::success('签到成功', [
'points' => $result['points'],
'continuous_days' => $result['continuous_days'],
'sign_date' => $result['sign_date'],
]);
} catch (UnauthorizedHttpException $e) {
return Json::fail($e->getMessage(), null, 401);
} catch (\Exception $e) {
return Json::fail($e->getMessage(), null, 400);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Get(
path: '/member/sign/status',
summary: '获取签到状态',
tags: ['会员签到'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getStatus(): Response
{
try {
/** @var CurrentMember $currentMember */
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$memberId = $member['id'];
$result = $this->service->getStatus($memberId);
return Json::success('获取成功', $result);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Get(
path: '/member/sign/calendar',
summary: '获取签到日历',
tags: ['会员签到'],
parameters: [
new OA\Parameter(name: 'year', description: '年份', in: 'query', schema: new OA\Schema(type: 'integer')),
new OA\Parameter(name: 'month', description: '月份', in: 'query', schema: new OA\Schema(type: 'integer')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getCalendar(Request $request): Response
{
try {
/** @var CurrentMember $currentMember */
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$memberId = (int)$member['id'];
$year = (int)$request->input('year', date('Y'));
$month = (int)$request->input('month', date('m'));
// 调用服务层获取签到日历
$result = $this->service->getCalendar($memberId, $year, $month);
return Json::success('获取成功', $result);
} catch (UnauthorizedHttpException $e) {
return Json::fail($e->getMessage(), null, 401);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Get(
path: '/member/sign/statistics',
summary: '获取签到统计',
tags: ['会员签到'],
parameters: [
new OA\Parameter(name: 'type', description: '统计类型 (week/month/year)', in: 'query', schema: new OA\Schema(type: 'string')),
new OA\Parameter(name: 'year', description: '年份', in: 'query', schema: new OA\Schema(type: 'integer')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 401, description: '未登录'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getStatistics(Request $request): Response
{
try {
/** @var CurrentMember $currentMember */
$currentMember = Container::make(CurrentMember::class);
$member = $currentMember->user(true);
if (empty($member)) {
throw new UnauthorizedHttpException('用户凭证失效请重新登录');
}
$memberId = (int)$member['id'];
$type = $request->input('type', 'month');
// 调用服务层获取签到统计
$result = $this->service->getStatistics($memberId, $type);
return Json::success('获取成功', $result);
} catch (UnauthorizedHttpException $e) {
return Json::fail($e->getMessage(), null, 401);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,95 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: https://madong.tech
*/
namespace app\api\controller\site;
use app\api\controller\Base;
use app\service\api\web\AdvertisementService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Request;
use Webman\Http\Response;
#[OA\Tag(name: '广告模块')]
final class AdvertisementController extends Base
{
public function __construct(AdvertisementService $service)
{
$this->service = $service;
}
/**
* 获取广告列表
*
* @return Response
*/
#[OA\Get(
path: '/site/ads',
summary: '获取广告列表',
tags: ['广告模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: '[]')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function index(): Response
{
try {
$result = $this->service->getAds();
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 获取广告位信息
*
* @param Request $request
*
* @return Response
*/
#[OA\Get(
path: '/site/ads/info',
summary: '获取广告位信息',
tags: ['广告模块'],
parameters: [
new OA\Parameter(
name: 'type',
description: '广告类型',
in: 'query',
required: false,
schema: new OA\Schema(type: 'string')
),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: '[]')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getInfo(Request $request): Response
{
try {
$params = $request->get();
$result = $this->service->getAdvertisementInfo($params);
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,94 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: https://madong.tech
*/
namespace app\api\controller\site;
use app\api\controller\Base;
use app\service\api\web\LinkService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Request;
use Webman\Http\Response;
#[OA\Tag(name: '友情链接模块')]
final class LinkController extends Base
{
public function __construct(LinkService $service)
{
$this->service = $service;
}
/**
* 获取链接列表
*
* @param Request $request
*
* @return Response
*/
#[OA\Get(
path: '/site/link',
summary: '获取友情链接',
tags: ['友情链接模块'],
parameters: [
new OA\Parameter(
name: 'type',
description: '链接类型(footer-页脚)',
in: 'query',
required: false,
schema: new OA\Schema(type: 'string', default: 'footer')
),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: '[]')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function index(Request $request): Response
{
try {
$type = $request->get('type', 'footer');
$result = $this->service->getLinksByType($type);
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 获取所有链接
*
* @return Response
*/
#[OA\Get(
path: '/site/link/all',
summary: '获取所有链接',
tags: ['友情链接模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: '[]')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getAll(): Response
{
try {
$result = $this->service->getAllLinks();
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,46 @@
<?php
declare(strict_types=1);
namespace app\api\controller\site;
use app\api\controller\Base;
use app\service\api\web\MenuService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use Webman\Http\Response;
#[OA\Tag(name: '导航菜单模块')]
final class MenuController extends Base
{
public function __construct(MenuService $service)
{
$this->service = $service;
}
/**
* 获取导航菜单列表
*
* @return Response
*/
#[OA\Get(
path: '/site/nav',
summary: '导航菜单',
tags: ['导航菜单模块'],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: '[]')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function index(): Response
{
try {
$result = $this->service->getNavigationList();
return Json::success('获取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,40 @@
<?php
declare(strict_types=1);
namespace app\api\controller\system;
use app\api\controller\Base;
use app\service\api\system\AgreementService;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use Webman\Http\Response;
#[OA\Tag(name: '协议模块')]
final class AgreementController extends Base
{
public function __construct(AgreementService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/agreement/{key}',
summary: '获取协议内容',
tags: ['协议模块'],
parameters: [
new OA\Parameter(name: 'key', description: '协议标识', in: 'path', required: true, schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 404, description: '协议不存在'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getAgreementContent(string $key): Response
{
$result = $this->service->getAgreementContent($key);
return json($result);
}
}
@@ -0,0 +1,83 @@
<?php
declare(strict_types=1);
namespace app\api\controller\system;
use app\api\controller\Base;
use app\service\api\system\CaptchaService;
use core\captcha\Captcha;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Request;
use Webman\Http\Response;
/**
* 验证码控制器
*/
#[OA\Tag(name: '验证码模块')]
final class CaptchaController extends Base
{
public function __construct(CaptchaService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/captcha',
summary: '获取验证码图片',
tags: ['验证码模块'],
parameters: [
new OA\Parameter(name: 'time', description: '时间戳,用于防止缓存', in: 'query', schema: new OA\Schema(type: 'integer')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function captcha(Request $request): \support\Response
{
try {
$captcha = new Captcha();
$type = $request->input('type', 'web-login');
$result = $captcha->captcha($request, $type);
return Json::success('ok', $result);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
/**
* 发送短信验证码
*/
#[OA\Post(
path: '/sms/{type}',
summary: '发送短信验证码',
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['mobile'],
properties: [
new OA\Property(property: 'mobile', description: '手机号', type: 'string'),
]
)
),
tags: ['验证码模块'],
parameters: [
new OA\Parameter(name: 'type', description: '验证码类型(login, register, bind等)', in: 'path', required: true, schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '发送成功'),
new OA\Response(response: 400, description: '参数错误'),
new OA\Response(response: 429, description: '发送过于频繁'),
]
)]
#[SimpleResponse(schema: [], example: [])]
public function sendSmsCode(string $type): Response
{
$result = $this->service->sendSmsCode($type);
return json($result);
}
}
@@ -0,0 +1,235 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: http://www.madong.tech
*/
namespace app\api\controller\system;
use app\api\controller\Base;
use app\api\middleware\ApiAccessTokenMiddleware;
use app\api\schema\request\system\ConfigGroupQueryRequest;
use app\api\schema\request\system\ConfigQueryRequest;
use app\api\schema\request\system\ConfigValueRequest;
use app\service\api\system\ConfigService;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\annotation\Middleware;
use support\Request;
use WebmanTech\Swagger\DTO\SchemaConstants;
//#[Middleware(ApiAccessTokenMiddleware::class)]
final class ConfigController extends Base
{
public function __construct(ConfigService $service)
{
$this->service = $service;
}
/**
* 按分组获取配置
*
* @param Request $request
* @param string $group_code
*
* @return \support\Response
* @throws \Exception
*/
#[OA\Get(
path: "/system/config/group/{group_code}",
summary: "按分组获取配置",
tags: ["系统配置"],
x: [
SchemaConstants::X_SCHEMA_REQUEST => ConfigGroupQueryRequest::class,
]
)]
#[SimpleResponse(schema: [], example: '{"site_open": "1","site_url": "http://127.0.0.1:8001","site_name": "madong-admin","site_logo": "https://madong.tech/assets/images/logo.svg","site_network_security": "2024042441号-2","site_description": "快速开发框架","site_record_no": "2024042442","site_icp_url": "https://beian.miit.gov.cn/","site_network_security_url": ""}')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getByGroup(Request $request, string $group_code): \support\Response
{
try {
// 参数验证
if (empty($group_code)) {
return Json::fail('分组编码不能为空');
}
$options = [
'enabled_only' => $request->input('enabled_only', true),
'with_metadata' => $request->input('with_metadata', false),
];
$result = $this->service->getByGroup($group_code, [], $options);
return Json::success('操作成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Get(
path: "/system/config/code/{code}",
summary: "按code获取配置",
tags: ["系统配置"],
x: [
SchemaConstants::X_SCHEMA_REQUEST => ConfigQueryRequest::class,
]
)]
#[OA\Parameter(
name: "code",
description: "配置编码",
in: "path",
required: true,
schema: new OA\Schema(type: "string"),
)]
#[SimpleResponse(schema: [], example: ' {"site_open": "1","site_url": "http://127.0.0.1:8001"}')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getByCode(Request $request, string $code): \support\Response
{
try {
// 参数验证
if (empty($code)) {
return Json::fail('配置编码不能为空');
}
$groupCode = $request->input('group_code', '');
$options = [];
if (!empty($groupCode)) {
$options['group_code'] = $groupCode;
}
$result = $this->service->config($code, [], $options);
return Json::success('操作成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 获取特定配置项的特定键值
*
* @param Request $request
* @param string $code
*
* @return \support\Response
* @throws \Exception
*/
#[OA\Get(
path: "/system/config/{code}/value",
summary: "获取特定配置项的特定键值",
tags: ["系统配置"],
x: [
SchemaConstants::X_SCHEMA_REQUEST => ConfigValueRequest::class,
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getValue(Request $request, string $code): \support\Response
{
try {
// 参数验证
if (empty($code)) {
return Json::fail('配置项编码不能为空');
}
$groupCode = $request->input('group_code');
$key = $request->input('key');
if (empty($groupCode) || empty($key)) {
return Json::fail('分组编码和配置键不能为空');
}
$result = $this->service->getValue($code, $key, null, ['group_code' => $groupCode]);
return Json::success('操作成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
/**
* 获取所有配置并按分组整理
*
* @param Request $request
*
* @return \support\Response
* @throws \Exception
*/
#[OA\Get(
path: "/system/config/all-grouped",
summary: "获取所有配置并按分组整理",
tags: ["系统配置"],
)]
#[OA\Parameter(
name: "enabled_only",
description: "是否只获取启用的配置项",
in: "query",
required: false,
schema: new OA\Schema(type: "boolean", default: true),
)]
#[OA\Parameter(
name: "group_filter",
description: "分组过滤,多个分组用逗号分隔",
in: "query",
required: false,
schema: new OA\Schema(type: "string"),
)]
#[OA\Parameter(
name: "with_metadata",
description: "是否包含配置项的完整元数据",
in: "query",
required: false,
schema: new OA\Schema(type: "boolean", default: false),
)]
#[OA\Parameter(
name: "key_by",
description: "按指定字段作为键名('code' 或 'id')",
in: "query",
required: false,
schema: new OA\Schema(type: "string", enum: ["code", "id"]),
)]
#[OA\Parameter(
name: "sort_groups",
description: "是否对分组进行排序",
in: "query",
required: false,
schema: new OA\Schema(type: "boolean", default: false),
)]
#[OA\Parameter(
name: "sort_configs",
description: "是否对配置项进行排序",
in: "query",
required: false,
schema: new OA\Schema(type: "boolean", default: false),
)]
#[SimpleResponse(schema: [], example: '{"site": {"site_name": "网站名称"}, "oss": {"accessKeyId": "xxx"}}')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getAllGrouped(Request $request): \support\Response
{
try {
$options = [
'enabled_only' => $request->input('enabled_only', true),
'with_metadata' => $request->input('with_metadata', false),
'key_by' => $request->input('key_by', null),
'sort_groups' => $request->input('sort_groups', false),
'sort_configs' => $request->input('sort_configs', false),
];
// 处理分组过滤参数
$groupFilter = $request->input('group_filter', '');
if (!empty($groupFilter)) {
$options['group_filter'] = explode(',', $groupFilter);
}
$result = $this->service->getAllGrouped($options);
return Json::success('操作成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,171 @@
<?php
declare(strict_types=1);
namespace app\api\controller\system;
use app\api\controller\Base;
use app\api\CurrentMember;
use app\dao\system\FeedbackDao;
use core\exception\handler\UnauthorizedHttpException;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use Webman\Http\Request;
use Webman\Http\Response;
#[OA\Tag(name: '问题反馈')]
final class FeedbackController extends Base
{
private FeedbackDao $dao;
public function __construct(FeedbackDao $dao, private readonly CurrentMember $currentMember)
{
$this->dao = $dao;
}
#[OA\Get(
path: '/feedback/mine',
summary: '获取当前用户的问题反馈列表',
tags: ['问题反馈'],
parameters: [
new OA\Parameter(name: 'page', description: '页码', in: 'query', schema: new OA\Schema(type: 'integer', default: 1)),
new OA\Parameter(name: 'limit', description: '每页数量', in: 'query', schema: new OA\Schema(type: 'integer', default: 10)),
],
responses: [new OA\Response(response: 200, description: '获取成功')]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: true, requirePermission: false, description: '会员接口')]
public function mine(Request $request): Response
{
try {
$memberId = $this->currentMember->id();
if (!$memberId) {
throw new UnauthorizedHttpException('请先登录后查看反馈记录');
}
$page = max(1, (int)$request->get('page', 1));
$limit = min(50, max(1, (int)$request->get('limit', 10)));
$where = ['created_by' => $memberId];
$total = $this->dao->getCount($where);
$items = $this->dao->selectList($where, '*', $page, $limit, 'created_at desc')?->values()->all() ?? [];
return Json::success('ok', [
'items' => $items,
'total' => $total,
'page' => $page,
'limit' => $limit,
]);
} catch (\Throwable $e) {
return Json::fail($e->getMessage(), [], $e instanceof UnauthorizedHttpException ? 401 : 0);
}
}
#[OA\Get(
path: '/feedback/mine/{id}',
summary: '获取当前用户的问题反馈详情',
tags: ['问题反馈'],
parameters: [new OA\Parameter(name: 'id', description: '反馈 ID', in: 'path', required: true, schema: new OA\Schema(type: 'string'))],
responses: [new OA\Response(response: 200, description: '获取成功')]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: true, requirePermission: false, description: '会员接口')]
public function mineShow(Request $request): Response
{
try {
$memberId = $this->currentMember->id();
if (!$memberId) {
throw new UnauthorizedHttpException('请先登录后查看反馈记录');
}
$feedback = $this->dao->get([
'id' => $request->route->param('id'),
'created_by' => $memberId,
]);
if (!$feedback) {
return Json::fail('反馈记录不存在或无权查看', [], 404);
}
$feedback->load('replyAdmin');
return Json::success('ok', $feedback->toArray());
} catch (\Throwable $e) {
return Json::fail($e->getMessage(), [], $e instanceof UnauthorizedHttpException ? 401 : 0);
}
}
#[OA\Post(
path: '/feedback',
summary: '提交问题反馈',
tags: ['问题反馈'],
requestBody: new OA\RequestBody(
required: true,
content: new OA\JsonContent(
required: ['type', 'content', 'source'],
properties: [
new OA\Property(property: 'type', description: '反馈类型:bug/suggestion/correction', type: 'string'),
new OA\Property(property: 'content', description: '问题描述,最多2000个字符', type: 'string'),
new OA\Property(property: 'contact', description: '联系方式,最多100个字符', type: 'string'),
new OA\Property(property: 'images', description: '截图地址列表,最多3张', type: 'array', items: new OA\Items(type: 'string')),
new OA\Property(property: 'source', description: '反馈来源:app/web', type: 'string'),
]
)
),
responses: [
new OA\Response(response: 200, description: '提交成功'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function store(Request $request): Response
{
try {
$data = $request->post();
$data['content'] = trim((string)($data['content'] ?? ''));
$data['contact'] = trim((string)($data['contact'] ?? ''));
$data['source'] = (string)($data['source'] ?? 'app');
$data['images'] = $data['images'] ?? [];
$validator = validator($data, [
'type' => 'required|in:bug,suggestion,correction',
'content' => 'required|max:2000',
'contact' => 'nullable|max:100',
'images' => 'array|max:3',
'source' => 'required|in:app,web',
], [
'type.required' => '请选择反馈类型',
'type.in' => '反馈类型不正确',
'content.required' => '请填写问题描述',
'content.max' => '问题描述不能超过2000个字符',
'contact.max' => '联系方式不能超过100个字符',
'images.array' => '截图附件格式不正确',
'images.max' => '截图附件最多上传3张',
'source.required' => '请选择反馈来源',
'source.in' => '反馈来源不正确',
]);
if ($validator->fails()) {
throw new \InvalidArgumentException($validator->errors()->first());
}
$images = array_values(array_filter($data['images'], static fn ($image) => is_string($image) && $image !== ''));
$type = $data['type'];
$content = $data['content'];
$contact = $data['contact'];
$source = $data['source'];
$memberId = $this->currentMember->id();
$model = $this->dao->save([
'type' => $type,
'content' => $content,
'contact' => $contact,
'images' => $images,
'source' => $source,
'created_by' => $memberId ?: null,
]);
return Json::success('提交成功', ['id' => $model->id]);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,45 @@
<?php
declare(strict_types=1);
namespace app\api\controller\system;
use app\api\controller\Base;
use app\attribute\SkipApiEncrypt;
use core\tool\ApiEncryptService;
use core\tool\Json;
use madong\swagger\annotation\response\DataResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use support\Request;
use support\Response;
#[SkipApiEncrypt]
final class SecurityController extends Base
{
protected ApiEncryptService $encryptService;
public function __construct(ApiEncryptService $encryptService)
{
$this->encryptService = $encryptService;
}
#[OA\Get(path: '/system/security/api-encrypt/public-key', summary: '获取接口加密公钥', tags: ['system-security'])]
#[DataResponse(description: '获取成功')]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function publicKey(Request $request): Response
{
$publicKey = $this->encryptService->getPublicKey();
if ($publicKey === '') {
return Json::fail('接口加密公钥未配置');
}
return Json::success('获取成功', [
'enabled' => $this->encryptService->isEnabled(),
'scope' => $this->encryptService->getScope(),
'algorithm' => $this->encryptService->getAlgorithm(),
'key_version' => $this->encryptService->getKeyVersion(),
'public_key' => $publicKey,
]);
}
}
@@ -0,0 +1,90 @@
<?php
declare(strict_types=1);
namespace app\api\controller\system;
use app\api\controller\Base;
use app\service\api\system\WechatService;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use Webman\Http\Request;
use Webman\Http\Response;
/**
* 微信控制器
*/
#[OA\Tag(name: '微信模块')]
final class WechatController extends Base
{
public function __construct(WechatService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/wechat/auth-code',
summary: '获取微信授权码',
tags: ['微信模块'],
parameters: [
new OA\Parameter(name: 'redirect_url', description: '回调URL', in: 'query', schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getWechatAuthCode(Request $request): Response
{
$params = $request->get();
$result = $this->service->getWechatAuthCode($params);
return json($result);
}
/**
* 同步微信用户信息
*/
#[OA\Get(
path: '/wechat/sync',
summary: '同步微信用户信息',
tags: ['微信模块'],
parameters: [
new OA\Parameter(name: 'code', description: '微信授权码', in: 'query', required: true, schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '同步成功'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function syncWechatUserInfo(Request $request): Response
{
$params = $request->get();
$result = $this->service->syncWechatUserInfo($params);
return json($result);
}
#[OA\Get(
path: '/wechat/jssdk-config',
summary: '获取微信 JSSDK 配置',
tags: ['微信模块'],
parameters: [
new OA\Parameter(name: 'url', description: '当前页面URL', in: 'query', required: true, schema: new OA\Schema(type: 'string')),
],
responses: [
new OA\Response(response: 200, description: '获取成功'),
new OA\Response(response: 400, description: '参数错误'),
]
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function getWechatJssdkConfig(Request $request): Response
{
$params = $request->get();
$result = $this->service->getWechatJssdkConfig($params);
return json($result);
}
}
@@ -0,0 +1,229 @@
<?php
declare(strict_types=1);
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: http://www.madong.tech
*/
namespace app\api\controller\upload;
use app\api\controller\Base;
use app\service\api\upload\UploadService;
use core\exception\handler\AdminException;
use core\tool\Json;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\AllowAnonymous;
use OpenApi\Attributes as OA;
use OpenApi\Attributes\RequestBody;
use support\Request;
final class UploadController extends Base
{
public function __construct(UploadService $service)
{
$this->service = $service;
}
#[OA\Post(
path: '/file/image',
description: '上传图片文件,支持 JPG/PNG/GIF/WEBP 格式,最大 5MB',
summary: '图片上传',
tags: ['上传管理'],
)]
#[RequestBody(
required: true,
content: new OA\MediaType(
mediaType: 'multipart/form-data',
schema: new OA\Schema(
properties: [
new OA\Property(
property: 'file',
description: '图片文件',
type: 'string',
format: 'binary'
),
new OA\Property(
property: 'sub_dir',
description: '子目录路径,例如:video/202603',
type: 'string',
example: 'images'
),
]
)
)
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function image(Request $request): \support\Response
{
try {
$subDir = $request->input('sub_dir', 'image');
$subDir .= '/' . date('Ym');
$result = $this->service->uploadImage($subDir);
return Json::success('上传成功', $result->toArray());
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/file/video',
description: '上传视频文件,支持 MP4/AVI/MOV/WMV/FLV/MKV 格式,最大 100MB',
summary: '视频上传',
tags: ['上传管理'],
)]
#[RequestBody(
required: true,
content: new OA\MediaType(
mediaType: 'multipart/form-data',
schema: new OA\Schema(
properties: [
new OA\Property(
property: 'file',
description: '视频文件',
type: 'string',
format: 'binary'
),
new OA\Property(
property: 'sub_dir',
description: '子目录路径,例如:video/202603',
type: 'string',
example: 'video/202603'
),
]
)
)
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function video(Request $request): \support\Response
{
try {
$subDir = $request->input('sub_dir', 'video');
$subDir .= '/' . date('Ym');
$result = $this->service->uploadVideo($subDir);
return Json::success('上传成功', $result->toArray());
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/file',
description: '上传普通文件,支持文档和压缩包,最大 50MB',
summary: '文件上传',
tags: ['上传管理'],
)]
#[RequestBody(
required: true,
content: new OA\MediaType(
mediaType: 'multipart/form-data',
schema: new OA\Schema(
properties: [
new OA\Property(
property: 'file',
description: '文件',
type: 'string',
format: 'binary'
),
new OA\Property(
property: 'sub_dir',
description: '子目录路径,例如:file/202603',
type: 'string',
example: 'file/202603'
),
]
)
)
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function file(Request $request): \support\Response
{
try {
$subDir = $request->input('sub_dir', 'file');
$subDir .= '/' . date('Ym');
$result = $this->service->uploadFile($subDir);
return Json::success('上传成功', $result->toArray());
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/file/fetch-image',
description: '从远程URL下载图片并保存到服务器',
summary: '远程图片拉取',
tags: ['上传管理'],
)]
#[RequestBody(
required: true,
content: new OA\JsonContent(
properties: [
new OA\Property(
property: 'url',
description: '图片URL',
type: 'string',
example: 'https://example.com/image.jpg'
),
]
)
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function fetchImage(Request $request): \support\Response
{
try {
$url = $request->input('url', '');
if (empty($url)) {
throw new AdminException('图片URL不能为空');
}
$result = $this->service->fetchImage($url);
return Json::success('拉取成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/file/base64-image',
description: '上传Base64编码的图片',
summary: 'Base64图片上传',
tags: ['上传管理'],
)]
#[RequestBody(
required: true,
content: new OA\JsonContent(
properties: [
new OA\Property(
property: 'base64',
description: 'Base64编码的图片数据',
type: 'string',
example: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...'
),
]
)
)]
#[SimpleResponse(schema: [], example: [])]
#[AllowAnonymous(requireToken: false, requirePermission: false, description: '公共接口')]
public function base64Image(Request $request): \support\Response
{
try {
$base64 = $request->input('base64', '');
if (empty($base64)) {
throw new AdminException('Base64数据不能为空');
}
$result = $this->service->uploadBase64Image($base64);
return Json::success('上传成功', $result);
} catch (\Exception $e) {
return Json::fail($e->getMessage());
}
}
}