ThinkPHP如何实现二级域名部署_多应用模式下子域名绑定【教程】

说实话，二级域名部署这个东西，很多用 ThinkPHP 的朋友上来就想复杂了。觉得是不是要改入口文件、要复制好几套代码、要给不同域名配不同的项目目录？其实完全不用。核心思路就一句话：同一套代码，根据访问的子域名，自动加载不同的应用模块。比如 admin.example.com 走后台应用，api.example.com 走接口应用——关键就在这三步里了：开启域名部署、注册子域名规则、确保 Web 服务器正确传递 Host 头。

一、确认项目已启用多应用模式

这一步是基础，但如果项目还是单应用结构，后面的操作就没法做了。需要先确认几件事：

• 已经执行了 composer require topthink/think-multi-app 装了多应用扩展；
• 根目录下的 app/controller 目录已经删除——这一步其实是触发框架进入多应用识别模式的关键；
• 已经用 php think build admin、php think build api 等命令创建了独立的应用目录，比如 app/admin/、app/api/。

到这个阶段，每个应用就有了自己的 controller、route.php 和中间件配置，物理隔离是到位了。

二、开启并配置域名部署功能

接下来改配置。在 config/app.php 里，找到这个开关，把它设为 true：

'url_domain_deploy' => true,

这个配置的意思是告诉框架：URL 里的 Host 部分要参与路由解析。注意，这里用的是 url_domain_deploy，不是 TP3/TP5 时代的 APP_SUB_DOMAIN_DEPLOY，那个在 TP6 已经废弃了，别搞混。

配置完开关，接着要注册子域名规则。建议在 route/app.php 里写，结构比较清晰：

use think\Route;Route::domain('admin', 'admin');        // admin.example.com → 加载 app/admin/ 应用Route::domain('api', 'api');            // api.example.com → 加载 app/api/ 应用Route::domain('m', 'mobile');           // m.example.com → 加载 app/mobile/ 应用Route::domain('*', 'index');            // 其他未匹配子域名 → 默认走 app/index/ 应用

每条规则左边是子域名（支持通配符 *），右边是对应的应用名——也就是 app/ 下的目录名。不需要写控制器或方法，整个应用会被完整加载，干净利落。

三、Web 服务器必须正确传递 Host 头

这一步是很多开发者栽跟头的地方。Nginx 或 Apache 默认不会自动把子域名信息传给 PHP，需要显式配置。常见错误是：所有子域名都指向同一个 server 块，但没有做 Host 判定，结果不管访问哪个子域名，始终加载默认应用。

正确的 Nginx 配置示例：

server {    listen 80;    server_name admin.example.com;    root /path/to/your/project/public;    index index.php;    location / {        if (!-e $request_filename) {            rewrite ^(.*)$ /index.php?s=$1 last;        }    }    location ~ \.php$ {        fastcgi_pass php-fpm;        fastcgi_index index.php;        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;        include fastcgi_params;        // 关键：务必保留 Host 头，否则 TP6 无法识别子域名        fastcgi_param HTTP_HOST $host;    }}

特别注意那一行 fastcgi_param HTTP_HOST $host;，少了它，框架就不知道当前访问的是哪个子域名，路由绑定自然也就失效了。Apache 用户则需要确认 mod_rewrite 已启用，并在虚拟主机配置中确保 UseCanonicalName Off，同时加上类似 SetEnvIf Host "(.*)" HTTP_HOST=$1 的逻辑。

四、DNS 与本地测试准备

生产环境走正常流程：在 DNS 控制台添加 A 记录或 CNAME，比如 admin、api、m 都指向同一个服务器 IP。本地开发调试则更简单，直接改系统的 hosts 文件：

127.0.0.1 admin.test.com127.0.0.1 api.test.com127.0.0.1 m.test.com

改完之后，在浏览器访问 http://admin.test.com，框架就会自动加载 app/admin/ 下的路由和控制器，URL 里完全不需要带 /admin/ 这样的路径前缀，这才是真正意义上的子域名部署。