ThinkPHP 5、6、8 三版二级域名支持本质相同，均依赖 $_SERVER['HTTP_HOST'] 识别并绑定映射，但配置入口、多应用结构及底层约束差异显著，不可直接迁移；TP5.1 用 APP_SUB_DOMAIN_DEPLOY 开关与 domain_bind.php 数组硬编码分发，TP6 将绑定移至 config/app.php 的 domain_bind 数组且需扩展支持多应用，TP8 必须开启 auto_multi_app 并仅支持 domain_bind 映射，子应用需独立 config/ 和 route/ 目录；本地开发需 hosts 文件或 Nginx 泛域名匹配确保 HTTP_HOST 一致，否则 fallback 默认应用；数据库与多语言等需按应用级隔离配置，路由 domain() 仅在绑定成功后生效；升级建议 TP6 最平衡，TP8 不兼容老项目。
ThinkPHP 5、6、8 三版对二级域名的支持逻辑本质一致——都依赖 $_SERVER['HTTP_HOST'] 做识别，再通过绑定规则映射到应用或路由。但实现路径、配置位置、多应用结构和底层约束差异显著，不能复用同一套配置直接迁移。
配置入口与绑定机制差异
版本间最直观的区别在“谁管域名分发”：
-
TP5.1 及更早：靠
config/app.php中的APP_SUB_DOMAIN_DEPLOY开关 +domain_bind.php（数组硬编码，如['admin.example.com' => 'admin']）完成应用级分发；Route::domain()仅在该应用内生效，不改变上下文 -
TP6：启用
'url_domain_deploy' => true，绑定仍写在config/app.php的domain_bind数组里，但不再支持domain_bind.php独立文件；多应用需额外安装topthink/think-multi-app扩展 -
TP8：必须显式开启
'auto_multi_app' => true，且domain_bind是唯一官方支持的应用映射方式；app/multi.php已废弃，子应用必须自带config/和route/目录
本地开发统一域名识别的关键
所有版本成败都卡在一点：本地请求的 HTTP_HOST 必须和线上一致，否则框架直接 fallback 到默认应用。
- 禁用
app_host（只对 CLI 生效，Web 请求无效） - hosts 文件加真实子域名：
127.0.0.1 admin.example.com api.example.com - Nginx 配置泛域名匹配：
server_name *.example.com example.com;，并确保fastcgi_param HTTP_HOST $http_host;正确传递 - TP8 还要求每个子应用目录下存在
config/app.php，哪怕只含空数组，否则不识别为独立应用
数据库与语言等衍生功能适配
二级域名只是入口，后续隔离靠应用层级承接：
立即学习“PHP免费学习笔记（深入）”；
-
数据库：不能靠全局
database.php自动切换。TP5/6 在对应应用目录（如app/admin/config/database.php）放独立配置；TP8 同理，但路径必须是app/admin/config/database.php，且该文件需被 PSR-4 加载器识别 -
多语言：所有版本都需在中间件最早期手动调用
\think\Lang::setLang()，基于parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST)提取纯净域名查表映射；务必关闭allow_url_lang，否则?lang=会覆盖域名判断 -
路由增强：
Route::domain()在 TP5/6/8 中均可用于子应用内部精细化控制，但前提是domain_bind已成功将请求分发到对应应用上下文，否则无意义
避坑要点与升级建议
跨版本踩坑高频点集中在命名空间、加载时机和配置覆盖逻辑：
- TP6/8 控制器方法名必须小驼峰（
loginForm），TP5 允许下划线（login_form）；大小写错误在 Linux 下直接Class not found - .env 文件只覆盖显式调用
env()的字段（如'hostname' => env('DB_HOST', 'localhost')），其他配置项仍需改config/文件 - TP8 的
thinkphp/目录彻底消失，所有核心类走vendor/Composer 加载，不能再手动 require 或修改源码 - 老项目若还在用 TP3.2 或 TP5.1，不建议强行升级到 TP8；TP6 是当前最平衡的选择——性能稳定、文档成熟、社区支持持续，且已兼容 PHP 8.1+
