ThinkPHP5域名绑定需显式开启APP_SUB_DOMAIN_DEPLOY=>true，否则domain_bind配置无效；其值为模块名且目录必须存在，依赖$_SERVER['HTTP_HOST']匹配，Nginx须透传Host头。
ThinkPHP5 的域名绑定模块功能本身有效，但 config/app.php 中的 domain_bind 配置必须配合 APP_SUB_DOMAIN_DEPLOY 开关才能触发，否则完全不生效。
APP_SUB_DOMAIN_DEPLOY 必须设为 true
这是最常被忽略的前提条件。TP5 不会自动启用域名绑定逻辑，哪怕你写了 domain_bind 数组，只要 APP_SUB_DOMAIN_DEPLOY 是 false 或未定义，框架就当它不存在。
-
APP_SUB_DOMAIN_DEPLOY必须在config/app.php顶层（不是数组内部）显式声明为true - 该配置只影响应用级模块分发，不影响路由层的
Route::domain() - 若使用命令行或 CLI 环境运行（如定时任务），
$_SERVER['HTTP_HOST']为空，domain_bind自动失效，此时应改用参数或环境变量控制
domain_bind 数组写法与路径对应关系
TP5 的 domain_bind 是硬映射，值必须是合法模块名，且该模块目录必须真实存在、命名空间正确，否则报“模块不存在”。
- 键是完整域名（含端口，本地开发时如
admin.test:8080），不能带协议（http://）或路径 - 值是模块名（如
'admin'），不是控制器或方法；模块目录需位于app/admin/，且app/admin/config.php中的app_namespace应为app\admin - 多个域名绑同一模块可写多条：
'admin.example.com' => 'admin', 'manage.example.com' => 'admin' - 泛域名不支持，
'*.example.com'或'admin.*'均无效
入口文件和 Nginx 配置必须透传 HTTP_HOST
TP5 依赖 $_SERVER['HTTP_HOST'] 做匹配，如果 Web 服务器没把 Host 头传给 PHP，绑定永远失败。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 配置中必须包含
fastcgi_param HTTP_HOST $http_host;，漏掉这行会导致$_SERVER['HTTP_HOST']为空 - 本地开发务必改
hosts文件（如127.0.0.1 admin.test），并确保浏览器访问的是http://admin.test而非http://localhost:8080 - 不要用 PHP 内置服务器（
php -S）测试域名绑定——它不解析 Host 头，domain_bind在里面必然失效 - Apache 用户需确认
mod_rewrite开启，且.htaccess中没有覆盖HTTP_HOST的重写规则
调试时优先检查 $_SERVER['HTTP_HOST'] 和路由日志
绑定失败时，90% 的问题出在请求根本没进到绑定逻辑，而不是配置写错。
- 在
public/index.php开头加var_dump($_SERVER['HTTP_HOST']);die;，确认值是你期望的域名 - 开启调试模式后，查看
runtime/log/下的请求日志，搜索 “sub_domain” 或 “domain_bind”，看是否有匹配动作记录 - 如果日志里没出现任何 domain 相关提示，说明
APP_SUB_DOMAIN_DEPLOY没生效，或入口不是index.php - 模块加载失败报错如
ClassNotFoundException: class app\controller\Index，大概率是模块目录结构或命名空间不匹配，而非域名问题
真正卡住人的地方，往往不是配置语法，而是 HTTP_HOST 没传进来，或者你以为绑定了模块，其实框架压根没走到那一步。先确认请求头，再查开关，最后看目录结构——顺序不能反。
