ThinkPHP5域名绑定指定模块重写规则配置-ThinkPHP-PHP中文网

thinkphp5域名绑定模块不依赖重写规则，但需开启url_domain_deploy配置、正确注册route::domain()规则，并配合nginx/apache重写透传http_host与请求路径，否则将出现404或跳转默认模块。

thinkphp5域名绑定指定模块重写规则配置

ThinkPHP5 域名绑定模块本身不依赖重写规则，但必须配合正确的服务器重写配置才能让二级域名访问正常生效；否则会出现 404、跳转到默认模块、或 URL 中残留 index.php 等问题。

这是整个功能的开关和路由映射基础。不启用该配置，Route::domain() 完全无效。

在 config/app.php（或 config.php）中确认已设置：'url_domain_deploy' => true
在 route/route.php 中注册绑定，例如：Route::domain('m', 'mobile'); 表示访问 m.example.com 时自动进入 mobile 模块
若使用 com.cn 类域名，需额外配置 'url_domain_root' => 'example.com.cn'，否则子域名解析会错位
注意：绑定的是「模块名」，不是目录路径；模块必须真实存在于 app/ 下且命名全小写（如 app/mobile/）

很多文档仍沿用老旧的 if (!-e $request_filename) { rewrite ... } 写法，这在 Nginx 中易引发重定向循环或 PATH_INFO 解析失败，导致模块绑定后控制器找不到。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

正确做法是在 server 块的 location / 中使用：try_files $uri $uri/ /index.php?s=$uri&$args;
该规则确保所有非静态资源请求都透传给 index.php，由 ThinkPHP 自身的路由层识别子域名并分发到对应模块
不要在 location ~ \.php 块里重复处理 PATH_INFO；ThinkPHP5 默认能从 $_SERVER['PATH_INFO'] 或 $_SERVER['QUERY_STRING'] 中提取 s= 参数
如果用了宝塔或其它面板，伪静态模板选「ThinkPHP 5」而非「6」，因两者参数解析方式不同（TP5 用 s=，TP6 用 pathinfo）

Apache 的 RewriteRule 若未正确传递路径，会导致 Route::domain() 拿不到完整 Host 信息，从而无法匹配域名规则。

确保 .htaccess 中有：RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]（注意末尾的 PT 标志）
PT（PassThrough）是关键：它让重写后的 URI 进入下一个处理阶段，使 PHP 能通过 $_SERVER['REQUEST_URI'] 和 $_SERVER['HTTP_HOST'] 正确识别当前访问的子域名
避免写成 RewriteRule ^(.*)$ index.php?/$1 —— 这种 query string 方式会让框架丢失原始路径结构，域名绑定逻辑直接失效
确认 Apache 开启了 mod_rewrite，且站点配置中 AllowOverride 至少包含 FileInfo

本地调试失败，80% 是因为 DNS 解析或入口文件没走对，跟代码逻辑无关。

必须在系统 /etc/hosts（macOS/Linux）或 C:\Windows\System32\drivers\etc\hosts（Windows）中添加两行：127.0.0.1 example.com 和 127.0.0.1 m.example.com
确认 Web 服务器根目录指向的是 public/，不是项目根目录；否则 index.php 不在 Web 可访问路径下，域名绑定永远不触发
如果用的是百度云 BCH 等限制目录绑定的虚拟主机，需在 /webroot/index.php 中手动引入：require './public/index.php';，且重写规则也要相应调整为指向 /webroot/index.php
浏览器访问时，务必清空 DNS 缓存（sudo dscacheutil -flushcache 或 ipconfig /flushdns），否则可能还在解析旧 IP