ThinkPHP 5 域名绑定必须在 public/index.php 中通过 $_SERVER['HTTP_HOST'] 显式判断并定义 BIND_MODULE 或调用 Route::bind()，因 TP5 不支持 route/app.php 的 Route::domain()（该机制仅 TP6+ 且需开启 route_domain_bind），配置文件中的绑定设置均不参与请求分发。
ThinkPHP 5 的域名绑定不能只靠改配置，必须在入口文件 public/index.php 中显式判断 $_SERVER['HTTP_HOST'] 并设置模块或路由开关，否则任何 config 或 route 文件里的“绑定”都无效。
为什么 route/app.php 里的 Route::domain() 在 TP5 里基本不生效
TP5 默认不启用域名路由解析机制，Route::domain() 只有在开启 route_domain_bind 配置后才被框架识别，但该配置项在 TP5 中并不存在（是 TP6 引入的）。你在 TP5 的 route/app.php 里写 Route::domain('admin.xxx.com', [...])，框架直接跳过，不报错也不匹配——请求根本进不到那层逻辑。
常见错误现象：浏览器访问 http://admin.xxx.com，页面空白或 404，而 http://localhost 能正常打开；var_dump($_SERVER['HTTP_HOST']) 显示值正确，但路由没走预期分支。
- TP5 的域名分发发生在路由解析之前，靠的是入口脚本的硬编码判断
- 所有“多域名多模块”需求，必须回到
public/index.php做switch分支 - 别在
config/app.php里设app_host或url_domain_root来“模拟绑定”，它们只影响 URL 生成，不参与请求分发
入口文件 public/index.php 必须手动判断 HTTP_HOST
这是 TP5 实现域名绑定唯一可靠的方式。你需要修改 public/index.php，在 require 框架基础文件之后、App::run() 之前插入 host 判断逻辑。
立即学习“PHP免费学习笔记（深入）”；
典型写法：
define('APP_PATH', __DIR__ . '/../app/');
require __DIR__ . '/../thinkphp/base.php';
// 根据域名决定模块和路由开关
$host = $_SERVER['HTTP_HOST'] ?? '';
switch ($host) {
case 'www.xxx.com':
define('BIND_MODULE', 'home');
break;
case 'admin.xxx.com':
define('BIND_MODULE', 'admin');
break;
case 'api.xxx.com':
define('BIND_MODULE', 'api');
\think\Route::bind('api'); // 强制绑定 api 模块下的路由
break;
default:
define('BIND_MODULE', 'home');
}
\think\App::run()->send();
-
define('BIND_MODULE', ...)是核心，它让框架从指定模块启动，绕过默认模块查找 - 若某域名需关闭路由（比如后台静态页），可在对应分支加
\think\App::route(false) - 不要用
$_SERVER['SERVER_NAME']替代HTTP_HOST，前者可能被 Apache/Nginx 重写，不可靠 - 本地开发时注意端口：如果用
http://admin.xxx.com:8080，HTTP_HOST就是admin.xxx.com:8080，case 必须写全
配合 hosts 和 Web 服务器，三者缺一不可
仅改入口文件还不够。浏览器发不出请求，或者 Web 服务器没把请求交给 public/index.php，前面所有逻辑都白搭。
-
hosts 文件：Windows 在
C:\Windows\System32\drivers\etc\hosts加127.0.0.1 admin.xxx.com；macOS/Linux 用sudo nano /etc/hosts同样添加；改完必须执行ipconfig /flushdns（Win）或sudo dscacheutil -flushcache（macOS） -
Web 服务器 root 必须指向
public/：Apache 的DocumentRoot或 Nginx 的root都要设成项目public目录，否则.htaccess不生效、静态资源 404、甚至入口文件被直接下载 -
Apache 必须开启 AllowOverride All：否则
.htaccess里的伪静态规则失效，导致带路径的 URL（如/index/index）返回 404 -
Nginx 要配 try_files：确保所有非静态文件请求最终落到
/index.php，推荐规则：try_files $uri $uri/ /index.php?$query_string;
容易忽略的兼容性细节
TP5 对域名绑定没有统一抽象，很多看似合理的写法在特定环境会静默失败。
- HTTPS 环境下
HTTP_HOST不含协议，但如果你用反向代理（如 Nginx 转发到 PHP-FPM），需确认fastcgi_param HTTP_HOST $host;是否透传正确 - 使用 phpstudy/xampp 等集成环境时，
httpd-vhosts.conf中的ServerName必须和你switch里的字符串完全一致，大小写敏感，不能多空格 -
define('BIND_MODULE', ...)必须在base.php之后、App::run()之前，放错位置会导致定义被忽略 - 调试时加
die($host);在入口文件开头，能最快确认是 DNS 解析问题、Web 服务器转发问题，还是框架逻辑问题
真正卡住的往往不是“怎么写”，而是 HTTP_HOST 实际值和你写的 case 字符串之间差了一个端口、一个 www. 前缀，或者换行符没清干净。
