ThinkPHP使用路由域名绑定_本地测试与服务器环境配置对比-ThinkPHP-PHP中文网

thinkphp路由域名绑定本地不生效的根本原因是环境配置缺失：需修改hosts文件解析域名，web服务器（nginx/apache）配置对应server_name或virtualhost，且nginx必须传递http_host和https参数，禁用php内置服务器。

thinkphp使用路由域名绑定_本地测试与服务器环境配置对比

本地测试时 Route::domain() 绑定的子域名（比如 admin.test）打不开，浏览器直接报 DNS 错误或 404，不是框架问题，是环境没对齐。

根本原因：你的本地机器没把自定义域名解析到 127.0.0.1，Web 服务器（如 Apache/Nginx）也没配置对应 server_name 或 server block，请求压根没进到 ThinkPHP。

常见于 Nginx + FPM 环境，错误日志里出现 Undefined index: HTTP_HOST 或路由始终走 index，本质是 FastCGI 参数没传全。

ThinkPHP 的 Route::domain() 依赖 $_SERVER['HTTP_HOST']，而很多精简版 Nginx 配置漏了 fastcgi_param HTTP_HOST $http_host; 这行。

检查 Nginx 的 fastcgi_params 或站点配置中是否包含：fastcgi_param HTTP_HOST $http_host;
如果用了 try_files，确保 rewrite 规则没覆盖原始 Host 头（比如写成 try_files $uri /index.php?$query_string 是安全的；但若强行重写为 /index.php?_url=... 又没透传 Host，就会丢掉域名信息）
阿里云轻量应用服务器、腾讯云 CVM 默认 Nginx 模板常删掉这一行，手动补上即可
Apache 用户注意 mod_rewrite 开启状态，且 .htaccess 中不能用 RewriteCond %{HTTP_HOST} 做二次判断干扰框架逻辑

php think route:list 默认只输出主域名（app.domain）下的路由，其他 Route::domain() 定义的子域路由不会列出来，不代表没注册成功。

更麻烦的是：如果两个 domain 绑定用了相同路径前缀（比如都定义了 admin/），ThinkPHP 会按注册顺序匹配，后注册的被前一个吞掉——它不校验 domain 是否真正命中。

调试时用 var_dump(Route::getRules()) 查看完整规则数组，确认 domain 键下是否有对应子数组
避免在不同 domain 下定义完全相同的路由表达式（如 'admin/index'），哪怕 controller 不同，也建议加 domain 特征前缀（如 'admin-v1/index'）
使用 Route::domain('api', function () { ... }) 时，闭包内所有路由自动带上 domain 上下文，但不要在里面再嵌套 Route::domain()
TP6.1+ 支持 Route::domain(['api', 'admin'], function () {...}) 批量绑定，比写两次更稳

当域名绑定了 HTTPS，但部分资源（CSS/JS）仍通过 HTTP 加载，浏览器会拦截；更隐蔽的问题是：Nginx 把 HTTPS 请求转给 PHP-FPM 时，$_SERVER['HTTPS'] 可能还是空，导致 Url::build() 生成 HTTP 链接。

这不是 ThinkPHP 的 bug，是反向代理链路中协议信息丢失。

Nginx 配置里加：fastcgi_param HTTPS on;（仅限真实 HTTPS 终结点）
如果用了 CDN 或 WAF（如 Cloudflare），需加：fastcgi_param HTTPS $http_x_forwarded_proto; 并确保 CDN 设置了 X-Forwarded-Proto: https
TP6 中可在 config/app.php 设置 'https' => true 强制 URL 生成走 HTTPS，但仅适用于全站 HTTPS 场景
别在域名绑定路由里硬写 http:// 协议头，一律用相对协议 // 或让框架生成