ThinkPHP路由怎么配置_ThinkPHP路由规则设置技巧【详解】-ThinkPHP-PHP中文网

thinkphp 6 路由不生效首要检查 config/app.php 中 'app_route' => true；多应用需确保对应应用目录下有 route/app.php；cli 下需加 --with-route 才加载路由。

thinkphp路由怎么配置_thinkphp路由规则设置技巧【详解】

ThinkPHP 6 路由不生效？先检查 `app_route` 配置开关

默认情况下 ThinkPHP 6 的路由是关闭的，哪怕你写了 route/app.php 也没用。这是新手踩坑最多的一点——以为写完规则就自动跑起来了。

必须确认 config/app.php 中的 app_route 是 true：

// config/app.php
'app_route' => true,

如果项目启用了多应用模式，还要确保对应应用目录下有 route/app.php（不是根目录的 route/）
命令行环境（如 php think route:list）下路由默认不加载，除非显式启用 --with-route
app_route 设为 false 时，框架会跳过整个路由解析，直接走「模块/控制器/操作」硬编码路径

定义路由时别混用闭包和控制器方法，`Route::get` 和 `Route::rule` 行为不同

Route::get 等 HTTP 方法路由默认开启「严格模式」：只匹配 GET 请求，且不兼容其他方法；而 Route::rule 是宽松匹配，需手动指定 ['method' => 'GET'] 才等效。

常见错误是把带参数的路由写成：

Skill Weave Chains — 技能链路由引擎

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

下载

Route::get('user/:id', 'index/User/read'); // ✅ 正确
Route::rule('user/:id', 'index/User/read'); // ❌ 默认响应所有 method，POST 也能进，容易引发 CSRF 漏洞

带变量的路由（如 :id）必须用 Route::get/Route::post 等明确方法的注册方式，否则中间件、验证器可能错位
Route::rule 更适合做重定向或跨域代理类规则，日常业务推荐用 Route::get、Route::post 等语义化方法
闭包路由（function() { ... }）无法被 php think route:list 列出，调试困难，线上建议少用

路由变量 `:id` 匹配失败？检查正则约束和分隔符冲突

ThinkPHP 默认用 / 作为路由分隔符，但如果你的参数本身含斜杠（比如 Base64 编码的 token），:id 会截断到第一个 / 就停，导致匹配失败。

解决办法是加正则约束：

Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']);

\S+ 表示非空白字符任意长度，能吞掉 URL 中的斜杠
避免用 .*，它会贪婪匹配到末尾，可能吃掉后续路由段
如果变量名是 :name，但实际传了中文，需确认 config/route.php 中 url_html_suffix 是否为 false（.html 后缀会干扰中文解码）
Apache 用户注意：.htaccess 中的 RewriteRule 如果没加 [QSA]，查询参数（?a=1）会被丢弃

子域名 + 路由组嵌套时，`domain` 和 `group` 的顺序不能颠倒

子域名路由必须在外层用 Route::domain 包裹，再在内部调用 group；反过来写（先 group 再 domain）会导致路由注册失效，且无任何报错提示。

// ✅ 正确：domain 包裹 group
Route::domain('api.example.com', function () {
    Route::group('v1', function () {
        Route::get('users', 'api/v1.User/index');
    });
});

// ❌ 错误：group 里调用 domain，不会注册成功
Route::group('v1', function () {
    Route::domain('api.example.com', function () {
        Route::get('users', 'api/v1.User/index');
    });
});