<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* api.php
|
|
* Created by PhpStorm.
|
|
* Date: 2026/10/17
|
|
* Time: 09:40
|
|
* Author: qian.guo
|
|
* E-mail: yiyezhiqiutel@gmail.com
|
|
*
|
|
* 本文件:api 应用的路由
|
|
*
|
|
* 位置说明(多应用模式):
|
|
* 应用名 = api,所以本文件在 app/api/route/ 下。
|
|
* 多应用中间件会先取 URL 第一段作为应用名并把它从 pathinfo 中剥掉,
|
|
* 因此这里**不需要再写 api 前缀**,规则从 v1/ 开始。
|
|
*
|
|
* URL: /api/v1/health
|
|
* 应用: api ← 被剥掉
|
|
* 规则: v1/health ← 本文件的写法
|
|
* 控制器: app\api\controller\Common::health
|
|
*
|
|
* 为什么不用根 route/ 目录:
|
|
* 多应用模式下每个应用有独立的 route/ 目录。根 route/ 只在未进入应用时生效,
|
|
* 两边同时定义会让「哪条规则命中」变得不可预期,所以根 route/ 保持为空。
|
|
*
|
|
* 鉴权策略:需要登录的路由挂 LoginCheck,不需要的不挂。
|
|
* 不用「全局挂载 + 控制器内判断」—— 那种写法迟早会漏判一处。
|
|
*/
|
|
|
|
use app\middleware\LoginCheck;
|
|
use app\middleware\RateLimitCheck;
|
|
use think\facade\Route;
|
|
|
|
Route::group('v1', function () {
|
|
|
|
Route::get('health', 'Common/health');
|
|
|
|
/* ---------------- 登录 ---------------- */
|
|
Route::group('auth', function () {
|
|
// 登录接口必须限流:它是唯一免鉴权且会写数据的入口
|
|
// 不限流等于给脚本开一个无限注册机
|
|
Route::post('login', 'Auth/login')
|
|
->middleware(RateLimitCheck::class, 'auth_login', 20, 60);
|
|
|
|
// 校验 token 是否仍有效(前端冷启动用),必须挂在鉴权下
|
|
Route::get('check', 'Auth/checkToken')
|
|
->middleware(LoginCheck::class);
|
|
});
|
|
|
|
/* ---------------- 用户资料(全部需登录) ---------------- */
|
|
Route::group('user', function () {
|
|
Route::get('profile', 'User/getProfileInfo');
|
|
Route::post('profile', 'User/profileUpdate');
|
|
Route::post('deactivate', 'User/accountDeactivate');
|
|
})->middleware(LoginCheck::class);
|
|
|
|
/* ---------------- 测评 ---------------- */
|
|
Route::group('quiz', function () {
|
|
// 取试卷免登录:用户在「开始测评」时才登录,登录前就要能渲染首页
|
|
Route::get('paper', 'Quiz/getPaperInfo');
|
|
|
|
/*
|
|
* 交卷评分:免登录,但必须限流。
|
|
* 不限流的话,这里是唯一「免鉴权 + 会消耗 CPU」的入口,
|
|
* 一个循环就能把服务器打满。
|
|
* 阈值 10 次/分钟/IP:正常人 3 分钟内只会交一次卷,
|
|
* 留余量是为了容忍弱网重试与多人共用同一个出口 IP(如公司/学校)。
|
|
*/
|
|
Route::post('submit', 'Quiz/submitAnswers')
|
|
->middleware(RateLimitCheck::class, 'quiz_submit', 10, 60);
|
|
});
|
|
|
|
/* ---------------- 运维/调试 ---------------- */
|
|
Route::group('system', function () {
|
|
Route::get('strategies', 'Common/getStrategyList')
|
|
->middleware(RateLimitCheck::class, 'system', 30, 60);
|
|
});
|
|
});
|