ThinkPHP5路由分组怎么定义_ThinkPHP5路由分组简化配置【路由】-ThinkPHP-PHP中文网

thinkphp5路由分组必须用闭包定义，否则前缀、中间件、pattern等失效；正确写法为route::group('api', function(){ route::get('user','api/user/index'); })。

thinkphp5路由分组怎么定义_thinkphp5路由分组简化配置【路由】

ThinkPHP5 的路由分组必须用闭包定义，否则前缀、中间件、pattern 等配置全部失效——这不是可选项，是硬性限制。

Route::group() 必须配闭包，不能直接链式调用 get/post

常见错误是写成 Route::group('api')->get('user', 'api/User/index')，看着顺手，但实际什么都没注册成功。因为 Route::group() 返回的是 RuleGroup 实例，它不提供 get() 方法；所有子路由必须在闭包里用 Route::get()、Route::post() 等静态方法注册。

✅ 正确：Route::group('api', function () { Route::get('user', 'api/User/index'); });
❌ 错误：Route::group('api')->get('user', 'api/User/index');（get() 无处可调）
❌ 错误：Route::group('api', Route::get('user', '...'));（第二个参数必须是闭包，不是路由对象）
⚠️ 注意：闭包必须在路由加载阶段执行，比如写在 app/route/app.php 里；若在控制器或中间件中调用，此时路由已固化，完全无效

分组前缀拼接时斜杠处理不当会导致 404

ThinkPHP 不会自动修复双斜杠，//api/v1//user 这种路径直接匹配失败。手动加斜杠是最容易翻车的地方。

Skill Weave Chains — 技能链路由引擎

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

下载

✅ 推荐写法：Route::group('api/v1', function () { Route::get('user', '...'); }); → 匹配 /api/v1/user
❌ 危险写法：Route::group('/api/v1/', function () { Route::get('/user', '...'); }); → 实际注册为 //api/v1//user
? 验证方式：开启调试模式后访问 http://yourdomain.com/route:list，看真实注册的完整路径
? ->prefix('api/v1/') 链式调用更安全，它会自动去重补斜杠，但只作用于闭包内注册的路由

分组内资源路由必须显式指定命名空间

用 Route::resource() 时，URL 前缀会继承，但控制器类不会自动加上分组名作为命名空间前缀。漏掉这步，Class not found 几乎必现。

❌ 默认行为：Route::group('admin', function () { Route::resource('user', 'User'); }); → 控制器解析为 app\controller\User，不是 app\controller\admin\User
✅ 修复方式一：Route::resource('user', 'admin.User')->namespace('admin');
✅ 修复方式二（推荐）：Route::group('admin', function () { Route::resource('user', 'User')->namespace('admin'); });
⚠️ 中间件也得挂到分组对象上：->middleware(['Auth'])，不能塞进闭包里，否则只对最后一条路由生效，或报 Call to a member function middleware() on null

变量规则和后缀要统一设在分组对象上，别每条重复写

分组支持批量约束参数格式和 URL 后缀，这是为了减少冗余、避免漏配。但 pattern 和 ext 是“继承式”生效，不是“覆盖式”。

->pattern(['id' => '\d+', 'name' => '\w+'])：所有含 :id 或 :name 的路由都受限制，不匹配直接 404
->ext('json')：该分组下所有路由自动识别 .json 后缀（如 /api/user/1.json），无需手动解析
->prefix('api/v1/') 比把前缀写在分组名里更可控，避免分组名被误当路径使用
⚠️ 延迟解析（'url_lazy_route' => true）开启后，若分组里用了动态生成路由（比如循环读配置），反而每次请求都重新加载整个分组——比预加载还慢