ThinkPHP 8.0手册怎么使用？路由与验证机制深度解析-ThinkPHP-PHP中文网

thinkphp 8.0路由与验证必须严格按执行链路配置：路由需分三层顺序定义并加正则约束；注解路由须安装扩展、初始化且配置扫描路径；验证器场景需显式声明字段白名单并链式调用；路由缓存需关闭调试并带参数重建。

thinkphp 8.0手册怎么使用？路由与验证机制深度解析

ThinkPHP 8.0手册不是翻着看的文档堆，而是必须按执行链路拆解使用的操作指南：路由定义顺序错一位、验证器场景漏一个字段、注解没初始化——接口立刻404或静默跳过校验，根本不会报错提示你哪步错了。

路由定义顺序必须严格分层

第一步：打开 app/route/app.php，把所有不含变量的完整路径规则移到文件最顶部。例如：
Route::get('user/profile', 'User/profile');
Route::get('admin/login', 'Admin/Login/index');
Route::get('api/status', 'Api/Status/check');

第二步：紧接其后，写含单一变量的规则，但必须确保它们不覆盖更具体的子路径。比如 【user/:id/edit 必须排在 user/:id 之后】，否则访问 /user/123/edit 时，框架会把整个字符串 "123/edit" 当作 :id 的值，控制器收不到 edit 段。

第三步：把带多级变量或通配符的规则（如 user/*、article/:year/:month/:slug）放在最后。Route::miss() 语句也必须放在这里——它只在全部已注册规则遍历完仍未匹配时才触发。

变量规则必须加正则约束，不能靠默认

方法一：用括号内联正则替代默认:id
Route::get('user/:id([0-9]+)', 'User/read');
Route::get('post/:year([0-9]{4})/:month([01][0-9])', 'Post/archive');

方法二：用 ->pattern() 显式声明局部约束
Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']);
这一步很关键：默认 :token 遇到 URL 中的 / 就停，而 \S+ 能吞掉 Base64 编码里的斜杠；但别用 .*，它会一路吃到 URL 末尾，导致后续路由段丢失。

方法三：对可选变量也加约束，防止空值或非法字符穿透
Route::get('search[:q?]', 'Search/index')->pattern(['q' => '[\w\u4e00-\u9fa5\-_]+']);
中文支持靠这个正则生效，前提是 config/route.php 中 url_html_suffix 为 false，否则 .html 后缀会截断请求。

注解路由启用前必须完成三件事

第一件事：执行 composer require topthink/think-annotation 安装扩展。TP8.0 不内置注解能力，漏装就永远看不到 @Route 注解。

在SEO发布前，从路由清单生成XML网站地图和robots.txt

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

第二件事：在 app/bootstrap.php 最底部添加 AnnotationRoute::init();。config/annotation.php 里 'route' => ['enable' => true] 只控制解析开关，不调 init()，控制器上的注解永远不会被读取。

第三件事：检查控制器类是否在正确命名空间下。默认只扫描 app\controller，多应用如 admin 必须手动在 config/annotation.php 的 'controllers' 数组中加入 'app\admin\controller'，路径末尾的 \controller 不能省，且必须用双反斜杠转义。

验证器场景必须显式声明字段白名单

生成验证器类后，立刻检查 app/validate/UserValidate.php 的 $scene 属性是否完整列出各场景字段：
protected $scene = [
  'register' => ['name', 'email', 'mobile', 'password'],
  'login' => ['email', 'password'],
  'edit' => ['name', 'email']
];

漏写字段 = 不校验 = 也不保证它存在。比如 edit 场景没写 mobile，那即使用户 POST 了 mobile 字段，它也不会被校验；但如果你后续代码写了 $data['mobile']，就会直接报 PHP Notice。

调用时必须链式执行 scene() → check()：
$validate = new UserValidate();
if (!$validate->scene('register')->check($data)) {
return json(['error' => $validate->getError()]);
}