ThinkPHP路由分组_路由前缀和域名路由配置【技巧】-php教程-PHP中文网

路由前缀与域名路由不可混用，否则url()生成链接不带域名和前缀；route::group前缀仅作用于闭包内静态方法注册的路由，非链式调用；正确写法是前缀与子路径均不加开头斜杠，统一在闭包中定义。

thinkphp路由分组_路由前缀和域名路由配置【技巧】

路由前缀和域名路由不能混着配，否则 url() 生成的链接不带域名、也不含前缀——这是最常被忽略的底层冲突点。

根本原因是前缀只作用于闭包内用 Route::get()、Route::post() 等静态方法注册的路由，而不是靠返回值链式调用。常见错误写法：

Route::group('api', function () { ... })->prefix('v1') → prefix() 不透传进闭包，白写
Route::group('/api/', function () { Route::get('/user', ...); }) → 双斜杠叠加成 //api//user，404
漏掉闭包，直接 Route::group('api', ['user' => 'User/index']) → TP6+ 已废弃数组写法，路由不注册

正确姿势是：前缀字符串不带开头 /，子路由路径也不加开头 /，全部写在闭包里：

Route::group('api/v1', function () {
    Route::get('user/:id', 'api.v1.User/read');
    Route::post('user', 'api.v1.User/save');
});

Route::domain() 在 TP6 中默认不生效，必须开启 route_domain_bind 配置，且仅支持一级域名（如 admin.example.com），无法泛匹配或复用中间件。实际项目中更推荐用 route_domain 配置 + 普通分组。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

在 config/route.php 中定义：'route_domain' => ['api' => 'api.example.com']
在 route/app.php 中写：Route::domain('api', function () { Route::get('user', 'api.User/index'); });
域名键名 api 必须和 route_domain 数组的键完全一致，大小写敏感
别在 Route::domain() 闭包里再套 Route::group() —— 域名绑定优先级高于路径分组，嵌套会失效

注意：url('api.user') 默认仍生成相对路径，要带完整域名得手动加 ['domain' => true] 参数。

加了前缀但 url('index/index') 还是输出 /index/index，不是配置漏了，而是 URL 生成机制没对齐：

路由没设 name()：必须显式命名，如 Route::get('user', 'User/index')->name('api.user')，否则 url() 只按控制器/方法硬拼，无视前缀
用了资源路由但没指定命名空间：Route::resource('user', 'User') 在 api 分组里，控制器仍找 app\controller\User，得加 ->namespace('api')
缓存没清：改完路由后必须运行 php think route:clear，否则 url() 读的是旧缓存里的规则