如何配置ThinkPHP实现子域名部署？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1215个文字，预计阅读时间需要5分钟。
如果您在ThinkPHP项目中需要将不同子域名映射到对应模块或应用，但访问时始终进入默认入口或路由失效，可能是子域名未正确识别。以下是一些配置子域名映射的方法：
一、配置应用级子域名绑定（单应用模式）
该方式适用于单应用下按子域名区分模块，通过框架内置机制自动路由，无需修改Web服务器配置。核心是启用子域名部署并定义映射规则。
1、打开应用配置文件 config/app.php，确保启用子域名部署功能：
2、添加或确认以下配置项：'APP_SUB_DOMAIN_DEPLOY' => 1；
立即学习“PHP免费学习笔记（深入）”；
3、在 'APP_SUB_DOMAIN_RULES' 中定义子域名与模块的映射关系，例如：'admin' => 'admin', 'api' => 'api'；
4、若主域名后缀为 com.cn 等二级域名后缀，需额外设置 'APP_DOMAIN_SUFFIX' => 'com.cn'；
5、保存配置后，访问 admin.example.com 即自动进入 admin 模块，URL中不再显示模块名。
二、使用Route::domain动态注册子域名路由
该方式更灵活，支持完整域名、泛域名及IP地址绑定，且可在路由文件中集中管理，适用于需精细控制路由行为的场景。
1、在应用的 route/route.php 文件中引入路由门面：use think\facade\Route;；
2、调用 Route::domain() 注册单条规则，例如：Route::domain('blog', 'home/blog');；
3、或使用批量注册方式：Route::domain(['blog' => 'home/blog', 'admin' => 'admin', '*' => 'index']);；
4、注意匹配优先级顺序：完整域名（含IP）＞二级/三级域名＞泛三级域名＞泛二级域名；
5、确保已在公共配置中开启 'url_domain_deploy' => true。
三、Nginx服务器层子域名分发（推荐用于多应用隔离）
该方式绕过PHP层路由判断，由Web服务器直接将请求分发至指定入口文件，性能更高、上下文更纯净，适用于多应用独立部署场景。
1、为每个子域名单独配置一个 server 块，如 server_name admin.example.com;；
2、root 指向项目 public/ 目录；
3、将 index 设置为对应入口文件，例如：index admin.php;；
4、在 location ~ \.php$ 块中，显式传递入口路径：fastcgi_param SCRIPT_FILENAME $document_root/admin.php;；
5、创建独立入口文件 public/admin.php，并在其中定义 define('APP_NAME', 'admin');。
四、DNS与泛解析前置配置
子域名生效的前提是域名系统能正确解析请求，需确保DNS层面已支持目标子域名或通配符解析。
1、登录域名服务商控制台（如DNSPod、阿里云DNS）；
2、添加一条 A记录，主机名填写具体子域名（如 admin），记录值填服务器IP；
3、如需支持任意子域名，添加一条泛解析记录：主机名设为 *，记录类型为 A，记录值为服务器IP；
4、等待DNS生效（通常数分钟至数小时），可用 nslookup admin.example.com 或 ping admin.example.com 验证解析结果；
5、确认服务器防火墙及安全组已放行80/443端口。
五、Apache虚拟主机方式配置子域名
适用于使用Apache作为Web服务器的环境，通过VirtualHost实现请求分发，逻辑清晰且兼容性强。
1、启用 mod_rewrite 模块：a2enmod rewrite 并重启Apache；
2、在 sites-available 下为每个子域名创建独立配置文件，如 admin.example.com.conf；
3、配置 ServerName admin.example.com 及 DocumentRoot /path/to/project/public；
4、在 Directory 块中设置 AllowOverride All，确保 .htaccess 生效；
5、在项目根目录的 .htaccess 中添加重写规则，将请求转发至对应入口：RewriteRule ^(.*)$ index.php?m=admin&%{QUERY_STRING} [L]。
本文共计1215个文字，预计阅读时间需要5分钟。
如果您在ThinkPHP项目中需要将不同子域名映射到对应模块或应用，但访问时始终进入默认入口或路由失效，可能是子域名未正确识别。以下是一些配置子域名映射的方法：
一、配置应用级子域名绑定（单应用模式）
该方式适用于单应用下按子域名区分模块，通过框架内置机制自动路由，无需修改Web服务器配置。核心是启用子域名部署并定义映射规则。
1、打开应用配置文件 config/app.php，确保启用子域名部署功能：
2、添加或确认以下配置项：'APP_SUB_DOMAIN_DEPLOY' => 1；
立即学习“PHP免费学习笔记（深入）”；
3、在 'APP_SUB_DOMAIN_RULES' 中定义子域名与模块的映射关系，例如：'admin' => 'admin', 'api' => 'api'；
4、若主域名后缀为 com.cn 等二级域名后缀，需额外设置 'APP_DOMAIN_SUFFIX' => 'com.cn'；
5、保存配置后，访问 admin.example.com 即自动进入 admin 模块，URL中不再显示模块名。
二、使用Route::domain动态注册子域名路由
该方式更灵活，支持完整域名、泛域名及IP地址绑定，且可在路由文件中集中管理，适用于需精细控制路由行为的场景。
1、在应用的 route/route.php 文件中引入路由门面：use think\facade\Route;；
2、调用 Route::domain() 注册单条规则，例如：Route::domain('blog', 'home/blog');；
3、或使用批量注册方式：Route::domain(['blog' => 'home/blog', 'admin' => 'admin', '*' => 'index']);；
4、注意匹配优先级顺序：完整域名（含IP）＞二级/三级域名＞泛三级域名＞泛二级域名；
5、确保已在公共配置中开启 'url_domain_deploy' => true。
三、Nginx服务器层子域名分发（推荐用于多应用隔离）
该方式绕过PHP层路由判断，由Web服务器直接将请求分发至指定入口文件，性能更高、上下文更纯净，适用于多应用独立部署场景。
1、为每个子域名单独配置一个 server 块，如 server_name admin.example.com;；
2、root 指向项目 public/ 目录；
3、将 index 设置为对应入口文件，例如：index admin.php;；
4、在 location ~ \.php$ 块中，显式传递入口路径：fastcgi_param SCRIPT_FILENAME $document_root/admin.php;；
5、创建独立入口文件 public/admin.php，并在其中定义 define('APP_NAME', 'admin');。
四、DNS与泛解析前置配置
子域名生效的前提是域名系统能正确解析请求，需确保DNS层面已支持目标子域名或通配符解析。
1、登录域名服务商控制台（如DNSPod、阿里云DNS）；
2、添加一条 A记录，主机名填写具体子域名（如 admin），记录值填服务器IP；
3、如需支持任意子域名，添加一条泛解析记录：主机名设为 *，记录类型为 A，记录值为服务器IP；
4、等待DNS生效（通常数分钟至数小时），可用 nslookup admin.example.com 或 ping admin.example.com 验证解析结果；
5、确认服务器防火墙及安全组已放行80/443端口。
五、Apache虚拟主机方式配置子域名
适用于使用Apache作为Web服务器的环境，通过VirtualHost实现请求分发，逻辑清晰且兼容性强。
1、启用 mod_rewrite 模块：a2enmod rewrite 并重启Apache；
2、在 sites-available 下为每个子域名创建独立配置文件，如 admin.example.com.conf；
3、配置 ServerName admin.example.com 及 DocumentRoot /path/to/project/public；
4、在 Directory 块中设置 AllowOverride All，确保 .htaccess 生效；
5、在项目根目录的 .htaccess 中添加重写规则，将请求转发至对应入口：RewriteRule ^(.*)$ index.php?m=admin&%{QUERY_STRING} [L]。