You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

80 lines
3.1 KiB

<?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);
});
});