ThinkPHP5路由配置方法与URL重写设置教程-ThinkPHP-PHP中文网

thinkphp5路由生效需同时开启config/app.php中'url_route_on'=>true且合理配置'url_route_must'，并清除runtime缓存；动态参数必填用:id、可选用[:id]；url重写须匹配入口文件；上线前必须执行php think optimize:route生成路由缓存。

thinkphp5路由配置方法与url重写设置教程

ThinkPHP5路由开关必须在`config/app.php`里配，不是只改`route.php`

很多人改完route.php发现路由完全不生效，根本原因是没动核心开关。ThinkPHP5路由不是“注册了就跑”，而是依赖两个硬性配置项：

'url_route_on' => true：必须为true，否则Route::get()等所有注册全部被忽略
'url_route_must' => false（推荐初学者设为false）：设为true后，任何没明确定义的 URL（包括首页/）都会直接 404——常有人开了url_route_on又忘了关url_route_must，结果连/index/index都打不开，误以为框架坏了

这两个值必须同时生效，缺一不可。改完config/app.php后无需重启服务，但要清空runtime/目录下缓存（或至少删掉runtime/route.php），否则旧缓存会掩盖配置变更。

动态参数写法：`:id`和`[:id]`语义完全不同

ThinkPHP5 对参数是否必填极其敏感，冒号前加不加方括号直接决定匹配行为：

'user/:id' → 必须带值，/user/123 OK，/user 直接 404
'user/[:id]' → 可选，/user 和 /user/123 都匹配，但控制器中需手动提供默认值：input('id', 'default') 或方法参数设默认值：public function index($id = 'default')
多个参数混用时顺序不能错：'blog/:year/:month/[:day]' 合法；'blog/:year/[:month]/:day' 会导致/blog/2026/5 匹配失败——因为[:month]后面还跟了必填:day，引擎无法回退补全

另外，完整路径匹配要用$结尾：'api/status$'只响应/api/status，不响应/api/status/或/api/status/extra。这个符号极易漏写，却直接影响 API 兼容边界。

Skill Weave Chains — 技能链路由引擎

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

下载

Apache/Nginx 的 URL 重写规则必须匹配 ThinkPHP 的入口模式

ThinkPHP5 默认使用 PATH_INFO 模式解析 URL，所以 Web 服务器必须把所有非静态资源请求转发给index.php。常见错误是直接复制网上泛用规则，却不核对入口文件名：

Apache：.htaccess里RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] 前提是入口文件叫index.php；如果用了admin.php，就得改成admin.php/$1
Nginx：rewrite ^(.*)$ /index.php?s=/$1 last; 中的s=是 ThinkPHP 内部识别 PATH_INFO 的关键参数，不能写成s=/或漏掉s=
IIS：需安装 URL Rewrite 模块，并导入规则；若用web.config，<match url="^(.*)$"></match> 后必须有<action type="Rewrite" url="index.php?s={R:1}"></action>，否则变量不传递