ThinkPHP5域名绑定路由分组配置实操教程-ThinkPHP-PHP中文网

thinkphp5中route::domain()不生效的根本原因是未开启url_domain_deploy配置，必须在config/app.php中显式设置'url_domain_deploy' => true，否则该路由规则会被静默忽略。

thinkphp5域名绑定路由分组配置实操教程

ThinkPHP5中`Route::domain()`为什么经常不生效

根本原因是没开 url_domain_deploy 配置。TP5 默认关闭域名部署，只开 url_route_on 不够。必须在 config/app.php 里显式设置：'url_domain_deploy' => true，否则 Route::domain() 定义的规则直接被忽略，连报错都没有，静默 fallback 到默认路由。

常见错误现象包括：子域名访问时始终进 index 模块、URL 生成不带域名、调试时发现路由日志里压根没匹配到 domain 规则。

配置项名是 url_domain_deploy，不是 route_domain_bind（那是 TP6 的）
TP5 不支持泛域名（如 *.example.com），只能写死完整子域名或主域名
如果用了多应用模式，Route::domain() 会和应用目录名冲突，优先走应用匹配，此时 domain 绑定可能被跳过

绑定到模块 vs 绑定到路由分组，怎么选

两者底层逻辑完全不同：Route::domain('admin', 'admin') 是「域名 → 模块」的硬跳转，一旦命中，直接绕过所有路由检查，进 admin 模块的默认控制器；而 Route::domain('admin', function(){...}) 是「域名 → 路由分组」，仍走完整路由匹配流程，支持中间件、参数约束、MISS 路由等。

实际项目里，90% 场景该用后者。前者看似简单，但无法定义具体 URL 路径、不能加中间件、URL 生成也不可控。

绑定到模块适合纯静态入口，比如 admin.example.com 全部交给 admin 模块处理
绑定到分组适合需要精细控制的场景，比如 api.example.com/v1/user 和 api.example.com/v2/user 分开定义
注意：分组内不能再嵌套 Route::domain()，否则报错

`route_config_file` 配置多个路由文件时的加载顺序

TP5 支持通过 'route_config_file' => ['home', 'admin', 'api'] 拆分路由配置，但加载是顺序执行的，后加载的规则会覆盖同路径的前序规则 —— 这不是 bug，是设计行为。

在SEO发布前，从路由清单生成XML网站地图和robots.txt

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

比如 home.php 里写了 Route::get('user', 'index/User/index')，admin.php 里又写了 Route::get('user', 'admin/User/index')，那最终生效的是后者。

推荐按「通用 → 专用」顺序排列，例如 ['common', 'home', 'admin']
不要在不同文件里重复定义同一 URL 路径，除非你明确需要覆盖
路由缓存命令 php think optimize:route 会合并所有文件，所以开发时改了路由要记得清缓存

生成带域名的 URL 时容易漏掉的关键参数

url() 函数默认只拼当前请求域名，哪怕你在 Route::domain('admin', ...) 里定义了规则，它也不会自动补上 admin.example.com。必须手动传 ['domain' => 'admin']，且这个键名必须和 Route::domain() 第一个参数完全一致（大小写敏感）。

示例：url('admin/index/index', [], ['domain' => 'admin']) 才会输出 http://admin.example.com/index/index；漏掉 ['domain' => 'admin'] 就还是当前域名。