ThinkPHP5域名绑定子目录模块访问设置-ThinkPHP-PHP中文网

thinkphp5不支持域名绑定子目录模块，模块是逻辑划分而非物理路径；route::domain()第二参数只能是闭包或数组，不能为字符串；启用域名绑定需同时满足开启url_domain_deploy、路由定义在route/app.php、web服务器指向public目录三条件。

thinkphp5域名绑定子目录模块访问设置

ThinkPHP5不支持“域名绑定子目录模块”这种说法——它没有子目录模块的概念，只有模块（module），而模块路径和URL结构是解耦的。所谓“绑定到子目录”，其实是误把Web服务器的目录映射当成了框架行为。

为什么 `Route::domain('m.example.com', 'mobile')` 不等于“绑定到 public/mobile 目录”

ThinkPHP5 的模块是逻辑划分，不是物理目录映射。mobile 是一个模块名，对应 application/mobile/ 目录（非 public/mobile）。public 下永远只放入口文件（如 index.php），所有请求都经由它统一调度。

写 Route::domain('m.example.com', 'mobile') 后，访问 m.example.com/index/index 实际调用的是 application/mobile/controller/Index.php 中的 index 方法
如果在 Nginx/Apache 里把 m.example.com 指向 public/mobile，框架根本收不到请求——直接 403 或 404，因为那里没有入口文件
本地开发时若用 php -S 启动，也必须确保路由入口（public/index.php）是唯一 Web 根目录，不能切到子目录

正确启用域名绑定的三步硬性条件

缺一不可，漏掉任意一条都会导致 Route::domain() 完全不生效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 application/config.php 中开启：'url_domain_deploy' => true
域名路由定义必须写在 route/app.php（不是 route/route.php，也不是 config/route.php）
确保 DNS 或 hosts 已解析该域名，并且 Web 服务器（Nginx/Apache）已将该域名指向项目 public/ 目录（不是子目录）

`Route::domain()` 第二个参数只能是闭包或数组，不能是字符串

这是最常翻车的点：很多人照着“绑定到模块”的描述，直接写成 Route::domain('m.example.com', 'mobile')，结果报错 Invalid route rule。

✅ 正确写法（闭包）：

Route::domain('m.example.com', function () {
    Route::get('/', 'index/index');
    Route::get('user/:id', 'user/read');
});

✅ 正确写法（数组，需配合配置式路由）：
```
return [
    '__domain__' => [
        'm' => 'mobile',
    ],
];
```
—— 注意这个写法要求 url_domain_deploy 开启，且必须放在 route/app.php 的 return 中
❌ 错误写法：Route::domain('m.example.com', 'mobile')（字符串路径）、Route::domain('m.example.com', 'mobile/index')、Route::domain('m.example.com', 'application/mobile')

多域名共用同一模块时，别和 `bind()` 混用

比如你希望 www.example.com 和 pc.example.com 都走 index 模块，但又在入口文件写了 \think\Route::bind('index')，就会出问题。

bind() 是全局入口绑定，作用于整个应用生命周期；domain() 是路由层匹配，只影响指定域名下的请求解析
两者叠加会导致模块前缀重复，例如请求 pc.example.com/ 可能被解析为 index\index\controller\Index，最终报错 Class index\controller\index does not exist
解决办法：删掉入口文件里的 bind()，全部用 Route::domain() 显式管理；或者只用 bind() + url_domain_deploy 配合 __domain__ 配置，二者不混用

真正容易被忽略的，是本地开发时 HTTP_HOST 带端口的问题——localhost:8000 和 Route::domain('test.com') 根本不匹配，得写成 Route::domain('localhost:8000') 或加环境判断。这点不处理，调试时永远 404。