ThinkPHP路由分组中如何绑定中间件与域名【路由】

ThinkPHP路由分组绑定中间件必须链式调用middleware()且写在Route::group()之后、闭包之前；域名绑定必须用Route::domain()并定义在route/app.php或route/domain.php中，开启url_domain_deploy配置。

ThinkPHP路由分组绑定中间件必须链式调用middleware()

中间件不会自动继承到分组内，->middleware('auth')必须写在Route::group()之后、闭包之前，否则只对某一条子路由生效，甚至完全不执行。

• ✅ 正确写法：Route::group('admin', function () { Route::get('user', 'Admin/User/index'); })->middleware('auth');
• ❌ 错误写法：Route::group('admin', function () { Route::get('user', 'Admin/User/index')->middleware('auth'); });——这只绑定了user路由，admin分组下其他路由不受影响
• ⚠️ 中间件名必须和config/middleware.php中aliases数组的键完全一致，大小写、下划线都不能错，比如配置里是'checkRole' => appmiddlewareCheckRole::class，就不能传'check_role'
• 多个中间件按顺序执行，传数组即可：->middleware(['auth', 'throttle', 'log'])

域名绑定必须用Route::domain()且写在route/app.php中

Route::domain()只能在route/app.php里定义才生效，写在config/route.php、中间件或控制器里完全无效；它不是“识别域名”，而是创建独立路由空间。

• ✅ 正确位置：打开route/app.php，写Route::domain('admin.example.com', function () { Route::get('index', 'Admin/Index/index'); });
• ❌ 常见错误：把域名判断逻辑塞进app/middleware.php，这只会读取Host头，但无法让url()生成带域名的链接，也无法触发路由匹配
• 第二参数必须是闭包或数组，不能是字符串路径，Route::domain('api.example.com', 'Api/Index/index')会直接报Invalid route rule
• 本地开发时注意HTTP_HOST含端口（如localhost:8000），需匹配完整，否则路由不命中

分组+域名组合使用时，中间件与前缀要各自显式挂载

一个域名分组里可以再套路由分组，但prefix()和middleware()都只作用于直接包裹的闭包，嵌套分组不会自动继承外层设置。

• Route::domain('admin.example.com', function () { Route::group('user', function () { Route::get('list', 'User/list'); })->middleware('role:user'); })->middleware('auth');——这里auth只对domain闭包内**未被子分组包裹**的路由生效，user分组里的list只走role:user
• 若需叠加，得手动重复写：->middleware(['auth', 'role:user'])，或改用统一前缀+控制器内中间件细化控制
• prefix()和middleware()位置固定：都在闭包前，顺序无关，但必须链式调用；->prefix('v1')->middleware('cors')和->middleware('cors')->prefix('v1')效果一样
• 前缀会自动规整斜杠：prefix('/api/')、prefix('api')最终都变成/api，子路由路径相对于它拼接

多应用模式下二级域名绑定要配url_domain_deploy并require模块路由

TP6/8 不支持模块自动绑定域名，必须开启url_domain_deploy，并在route/domain.php中用Route::domain() + require显式加载对应模块路由文件。

立即学习“PHP免费学习笔记（深入）”；

• 确认config/app.php中'url_domain_deploy' => true已开启（默认开启，但务必检查）
• 所有域名路由定义必须集中放在route/domain.php，不能散落在各模块自己的route.php里
• 写法示例：Route::domain('api.example.com')->group(function () { require __DIR__ . '/api.php'; });，其中api.php里定义Route::get('v1/user', ...)等规则
• 不要在Route::domain()闭包里直接写大量路由，否则难以复用模块内已有的Route::resource()等复杂定义，也容易和require的文件冲突

实际项目里最容易漏的是中间件名拼写和url_domain_deploy开关——前者导致鉴权静默失效，后者导致域名路由完全不触发，连404都不会报，只会 fallback 到默认路由。