ThinkPHP5域名绑定入口脚本修改配置教程-ThinkPHP-PHP中文网

thinkphp 5 域名绑定必须在 public/index.php 中通过 $_server['http_host'] 显式判断并定义 bind_module 或调用 route::bind()，因 tp5 不支持 route/app.php 的 route::domain()（该机制仅 tp6+ 且需开启 route_domain_bind），配置文件中的绑定设置均不参与请求分发。

thinkphp5域名绑定入口脚本修改配置教程

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

编写健壮的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 服务器转发问题，还是框架逻辑问题