ThinkPHP8路由分类默认处理机制详解【路由】-ThinkPHP-PHP中文网

thinkphp 8 路由匹配基于 request_uri 字符串顺序比对，静态路径须置顶、变量规则按优先级排列，约束需显式声明，分组为独立作用域，缓存仅保存映射关系。

thinkphp8路由分类默认处理机制详解【路由】

ThinkPHP 8 路由分类默认处理机制决定请求是否能命中控制器、变量能否正确提取、404 是否该出现——它不靠服务器 rewrite，而是 PHP 层逐条比对 REQUEST_URI 字符串，顺序错一位、约束漏一个、分组嵌套深一层，就足以让 /user/123/edit 返回 404 或把 edit 当作 id 值传进去。

路由匹配本质是字符串顺序匹配

框架启动后，Route::dispatch() 从 $_SERVER['REQUEST_URI'] 中截取路径部分（如 /api/v1/users/123），去掉域名、查询参数和入口文件前缀，再按注册顺序逐条比对规则。

每条 Route::get('user/:id', 'User/read') 内部会转成类似 ~^user/([^/]+?)/?$~ 的正则，用 preg_match 提取捕获组；【:id 默认等价于 ([^/]+?)，不支持中文或斜杠】，所以 /user/张三会匹配失败，/user/123/edit 会被截成 :id = "123/edit"。

静态路径必须排最前，否则会被带变量的规则吞掉。

路由规则注册顺序决定命中的优先级

第一步：打开 route/app.php，把所有不含变量的完整路径移到最前面。

Route::get('admin/login', 'Admin/Login/index');
Route::get('api/status', 'Api/Status/check');
Route::get('user/profile', 'User/profile');

第二步：含单一变量的规则紧接其后，但要确保不会覆盖子路径。比如 user/:id 必须写在 user/:id/edit 之前，否则后者永远无法命中。

第三步：多级变量或通配符规则放最后。Route::get('user/*', 'User/other') 这类规则一旦提前，就会吃掉所有以 user/ 开头的请求。

【Route::miss() 必须放在所有 Route::get/Route::post 之后】，它只在全部已注册规则遍历完仍未匹配时才触发。

变量约束必须显式声明才能突破默认限制

方法一：内联正则，直接改写路由表达式。

Route::get('user/:id([0-9]+)', 'User/read');
Route::get('post/:year([0-9]{4})/:month([01][0-9])', 'Post/archive');

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

方法二：用 ->pattern() 显式声明局部约束，比全局 __pattern__ 更安全。

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

方法三：全局变量规则，在 route/app.php 顶部统一设置。

Route::pattern(['id' => '[0-9]+', 'slug' => '[a-z0-9\-]+']);