ThinkPHP多域名部署在不同环境的差异_站点绑定与路由规划-ThinkPHP-PHP中文网

thinkphp多域名部署中app_host配置仅在cli模式生效，web环境依赖domain_bind开关、domain.php绑定及路由规则；需统一入口、避免虚拟主机分流，并注意url()跨域生成与本地开发环境一致性。

thinkphp多域名部署在不同环境的差异_站点绑定与路由规划

ThinkPHP 多域名部署时 `app_host` 配置为什么没生效

因为 ThinkPHP 的域名绑定逻辑不依赖 app_host，这个配置只在 CLI 模式下用于模拟请求 Host，Web 环境中完全被忽略。真正起作用的是 app_domain_bind 和路由层的域名规则。

常见错误现象：app_host 设了却始终走默认应用；不同域名访问都进同一个模块；Request::domain() 返回正确但路由没分发到对应应用。

必须在 config/app.php 中显式开启域名绑定：'domain_bind' => true
绑定关系写在 config/domain.php（需手动创建），格式为 ['www.a.com' => 'a', 'www.b.com' => 'b']，键是完整域名（含端口要带上），值是应用名
如果用子域名泛解析（如 *.example.com），得配合 sub_domain_deploy + sub_domain_rule，不能只靠 domain.php
Nginx/Apache 必须把所有域名都指向同一入口（public/index.php），不能按域名分虚拟主机再分别指入——否则 PHP 根本收不到 Host 头

多域名下 `url()` 生成链接为什么会跳回主域名

因为 url() 默认复用当前请求的 Host，但跨域名调用时，比如在 www.a.com 页面里生成 www.b.com 的链接，它不会自动切换——除非你告诉它。

使用场景：后台管理域（admin.example.com）需要跳转到用户前台（www.example.com）；SaaS 多租户各用独立域名，但统一后台要生成对应租户链接。

最直接的方式是传完整 URL：url('b/index/index', [], true, 'https://www.b.com')，第四个参数为协议+域名
更可持续的做法是定义域名常量或配置，在 config/url.php 里加 'domain_map' => ['b' => 'https://www.b.com']，然后封装一个 domain_url() 辅助函数
注意 url() 的第三个参数（suffix）和第四个参数（domain）顺序不能错，漏掉 true 就不会补全协议
如果启用了 URL 重写（url_html_suffix），跨域名链接末尾可能多出 .html，而目标域名未必支持该后缀，导致 404

本地开发（localhost）和线上（真实域名）路由行为不一致

核心原因是 ThinkPHP 判断是否启用域名绑定的依据是 $_SERVER['HTTP_HOST']，而本地常用 localhost:8080 或 127.0.0.1，这些不匹配 domain.php 里写的正式域名，直接 fallback 到默认应用。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

性能影响：每次请求都要做一次数组键查找（domain.php 映射表），域名数超 10 个后建议改用正则路由替代静态绑定。

开发时不要写 localhost 进 domain.php，改用 hosts 绑定真实域名（如 127.0.0.1 www.a.com），保持环境一致
避免在 route/route.php 中混用 domain 和 group 嵌套过深，ThinkPHP 6.1+ 对多层域名 group 支持不稳定，容易漏匹配
调试时用 var_dump(Request::host(), Request::domain(), app('http')->getName()) 确认当前匹配到的应用名，比看日志更快
如果用 Docker，确保容器内 /etc/hosts 和宿主机同步，否则 curl 请求内部服务时域名解析失败

`Route::domain()` 和 `app_domain_bind` 该选哪个

优先用 app_domain_bind（即 domain.php 静态绑定），它在应用初始化早期就完成分发，开销小、逻辑清晰；Route::domain() 是运行时路由匹配，适合需要动态判断的场景，比如按数据库查出的租户配置分流。

容易踩的坑：两个机制同时启用会冲突——app_domain_bind 匹配成功后，后续 Route::domain() 根本不执行。

静态绑定适合固定域名结构（如企业官网多个子站），动态路由适合 SaaS、白标系统
Route::domain('api.example.com', function () { ... }) 内部不能再嵌套另一个 Route::domain()，ThinkPHP 不支持二级域名路由嵌套
用 Route::domain() 时，记得在闭包里显式调用 Route::get() 等，它不会自动继承全局路由规则
上线前务必检查 config/app.php 中 'domain_bind' 开关是否为 true，测试环境常设为 false 导致线上失效

域名绑定不是“设了就完事”的功能，它和 Web 服务器配置、HTTPS 重定向、CDN 缓存头都有关联——比如 Nginx 把 http:// 强制跳 https:// 后，Request::domain() 取到的还是原始 Host，但生成的 URL 如果没指定协议，就可能变成 http:// 被浏览器拦截。