如何设置ThinkPHP多域名绑定及实现子域名路由映射？

本文共计1156个文字，预计阅读时间需要5分钟。

在使用ThinkPHP框架进行多域名绑定时，不能仅仅依赖于Route::domain()配置。还需要在application.php或对应域名的配置文件中，针对特定域名设置路由和配置参数。

domain_bind 配置必须写在 config/app.php 里

这是最常被跳过的一步。TP6 的多域名到模块/应用的硬绑定，依赖 domain_bind 数组，它在 config/app.php 中，不是 route/app.php。

• domain_bind 键必须是完整域名（如 'admin.example.com'），值必须是对应的应用目录名（如 'admin'），且该目录下要有 controller/、route/ 等标准结构
• 若值设为 'api'，框架会自动把控制器命名空间切为 api\controller，视图路径切为 app/api/view/，中间件也从 app/api/middleware.php 加载
• 开发时用 localhost:8000 测试，需在 domain_bind 里写全 'localhost:8000' => 'admin'，不能只写 'localhost'
• HTTPS 不影响匹配，但反向代理（如 Nginx SSL 终止）可能丢失原始 Host 头，导致 $_SERVER['HTTP_HOST'] 变成 127.0.0.1，此时要配 fastcgi_param HTTP_HOST $host;

Route::domain() 只适合同一应用内区分功能，别用来跨模块

Route::domain() 是路由规则层面的条件分支，它不切换应用上下文。你写了 Route::domain('api.example.com', ...)，请求仍走默认应用（如 app/），控制器还是去 app/controller/ 找 —— 所以报错 class not found: app\controller\Index 而不是 api\controller\Index。

• 适用场景：user.example.com 和 admin.example.com 都跑在 app 应用里，只是路由前缀和权限逻辑不同
• 不适用场景：想让 api.example.com 完全隔离使用独立数据库配置、中间件、日志目录
• 若硬要用，得在每个闭包里手动调 \think\App::bind('api')，但必须在 App::run() 前执行，且极易漏配、不可维护
• Route::domain('*') 支持泛域名，但 Route::domain('*.example.com') 无效 —— ThinkPHP 只认单个 *

Nginx/Apache 必须把域名请求精准指向 public/ 目录

Web 服务器配置错误，会导致所有域名都 fallback 到 index.php 或直接 403/500，根本进不了框架路由层。

立即学习“PHP免费学习笔记（深入）”；

• Apache：每个 <VirtualHost> 的 DocumentRoot 必须是项目 public/ 目录，且含 AllowOverride All；确认已启用 mod_rewrite
• Nginx：每个 server 块的 root 指向 /var/www/example/public，并在 location ~ \.php$ 里加 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
• 本地 hosts 测试泛域名时，不能只写 127.0.0.1 *.example.com —— 要逐行写，如 127.0.0.1 a.example.com、127.0.0.1 b.example.com
• Cookie/session 默认不跨子域名，若需共享，session.cookie_domain 和 cookie.domain 都得设为 '.example.com'（注意开头的点）

泛域名 + 子域名自动解析要手动提取

Route::domain('*') 只是打开通路，框架不会自动把 a.example.com 的 a 当作参数传给控制器。你得自己调 Request::subDomain() 或 Request::domain() 拿值。

• Request::subDomain() 返回字符串，主域名访问时返回空字符串 ''，不是 null，别用 === null 判断
• 常见做法：在路由闭包里用 switch 匹配子域名，再重定向或绑定到不同控制器；更稳的方式是封装一个 SubDomainDispatcher 类统一处理
• 若用了 Swoole/RoadRunner，APP_PATH 是进程级常量，每次请求都得重置，否则上一个请求的绑定会污染下一个
• 泛域名不等于自动 SEO 分离，搜索引擎仍需靠 hreflang 或独立 sitemap 来识别不同子站内容

真正麻烦的不是写几行配置，而是搞清哪一层该做什么：DNS 解析是系统层，Web 服务器转发是网络层，domain_bind 是框架应用分发层，Route::domain() 是路由匹配层。混着用，90% 的问题都出在这儿。