ThinkPHP 6+ 彻底移除 route.php 中数组式路由定义,因底层路由解析器重构为动态规则注册机制;旧写法如 return ['GET|/user'=>'index/user/index'] 不再被识别,必须改用 Route::get() 等方法显式注册,且控制器方法分隔符改为@、参数占位符改为、中间件需链式绑定。

ThinkPHP 6+ 已彻底移除 route.php 中数组式路由定义方式,强行沿用会直接报错 Call to undefined function think\route() 或路由不生效——这不是兼容开关能解决的,是底层路由解析器重构导致的硬性断裂。
为什么旧版 return ['GET|/user' => 'index/user/index'] 不再工作
ThinkPHP 5.1 尚支持数组返回值作为路由规则,但 TP6 路由系统完全基于 think\Route 类和注解/闭包/配置驱动,不再识别全局数组返回。核心变化是:路由注册从「静态数组映射」变为「动态规则注册 + 请求匹配器」,旧写法连解析入口都进不去。
- TP6 启动时只加载
app/route.php中的闭包或调用Route::get()等方法,不执行 return 的数组 - 即使把数组塞进闭包里
return ['GET|/x'=>'a/b/c'],框架也不会自动遍历注册——没这层逻辑了 - 常见错误现象:
404、MethodNotAllowedHttpException、控制台无任何路由提示(php think route:list列不出)
如何把旧数组路由平滑迁移到 TP6 标准写法
不是重写,而是结构化转换。关键点在于:把每个数组项拆成独立的 Route::rule() 或链式调用,并注意动词、变量、中间件绑定位置。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 原
'GET|/user' => 'index/user/index'→Route::get('/user', 'index/user/index') - 原
'POST|/api/login' => 'api/v1.Login/login'→Route::post('/api/login', 'api/v1.Login@login')(注意 TP6 控制器方法分隔符是@,不是/) - 含参数的如
'GET|/article/:id' => 'index/article/read'→Route::get('/article/<id>', 'index/article/read')</id>(变量占位符改用尖括号,非冒号) - 需中间件的,不能写在数组值里,得单独链式追加:
Route::get('/admin', 'admin/index')->middleware('checkAuth')
使用 Route::import() 批量导入时的坑
TP6 支持从 PHP 文件导入路由规则,但这个文件必须返回一个「规则数组」,且格式严格限定为键值对:key 是路由表达式,value 是完整操作(含中间件、参数约束等),不是旧版那种简单字符串映射。
立即学习“PHP免费学习笔记(深入)”;
- 错误示范:
return ['/user'=>'index/user/index']—— 这会被当成「控制器方法字符串」,不识别中间件、不校验参数类型 - 正确格式:
return ['/user'=>['index/user/index', ['middleware'=>['auth']]]] - 更推荐不用
import(),直接在app/route.php里写Route::get()等调用,调试清晰、IDE 可跳转、错误定位快 -
php think route:list必须能列出你的路由才算真正生效;如果列表为空,大概率是route.php没正确执行(比如用了return但没调用任何Route::xxx)
最易被忽略的是控制器方法语法变更:index/user/index 在 TP6 中实际对应 app\controller\index\User::index(),而旧写法常误写成 index/user.index 或漏掉命名空间路径。一旦方法找不到,路由虽注册成功,请求仍抛出 ClassNotFoundException —— 此时看日志比看路由列表还管用。


















