ThinkPHP在服务器部署多应用模式_域名区分模块配置实战-ThinkPHP-PHP中文网

thinkphp多应用模式下域名绑定需在入口文件用app::bind()实现，config/app.php的domain_bind无效；路由、静态资源路径、命名空间须与应用目录严格对应，nginx须统一指向public/且runtime可写。

thinkphp在服务器部署多应用模式_域名区分模块配置实战

多应用模式下域名绑定模块失败，`app.php` 配置不生效

ThinkPHP 多应用模式本身不支持直接通过域名自动切换应用，所谓“域名区分模块”是常见误解——模块（module）和应用（app）在 TP6+ 是两个层级：模块属于单个应用内划分，而多应用是多个独立 app 目录并存。真正能按域名路由到不同应用的，必须靠入口文件或路由调度层控制。

实操建议：

确认你用的是 TP6.1+，且已启用多应用模式（app_multi = true，default_app 可留空）
不要在 config/app.php 里写 'domain_bind' => ['a.com' => 'admin'] —— 这是旧版单应用的写法，TP6 多应用下该配置被忽略
正确做法是：在 public/index.php 入口处手动读取 $_SERVER['HTTP_HOST']，再调用 think\App::bind() 绑定应用名，例如：
```
if ($_SERVER['HTTP_HOST'] === 'admin.example.com') {
    \think\App::bind('admin');
}
```
注意：绑定必须在 App::run() 之前，且不能晚于 require __DIR__ . '/../vendor/autoload.php'; 之后

子域名解析到不同应用时，`route.php` 路由不匹配

即使应用成功绑定，子域名下的路由仍走默认应用的 route.php，因为 TP 默认只加载当前绑定应用下的路由文件，但若入口没显式指定应用路径，框架会 fallback 到 app/route.php（即默认应用），而不是 app/admin/route.php。

实操建议：

确保每个应用目录下都有独立的 route.php（如 app/admin/route.php），且内容以 use think\facade\Route; 开头
检查 app/admin/config/app.php 中的 'default_route' => true 是否为 true；若为 false，需手动在 app/admin/route.php 中调用 Route::get() 等注册
调试时可在 app/admin/route.php 开头加 dump('admin route loaded');，确认是否被执行
避免在根 app/route.php 里写全局路由规则，它只对默认应用生效，其他应用不会继承

部署后静态资源 404，`public/static/` 路径错乱

多应用模式下，静态资源默认仍从 public/static/ 加载，但如果你把不同应用的前端资源分开存放（比如 public/static/admin/ 和 public/static/api/），模板里用 static('css/app.css') 就会出错——这个函数不感知当前应用，始终拼接根 static/ 下的路径。

实操建议：

不要依赖 static() 自动推导，改用绝对路径或应用前缀：
```
<link rel="stylesheet" href="/static/admin/css/app.css">
```
如果必须动态生成，可在应用配置中加自定义项，如 app/admin/config/app.php 里设 'static_prefix' => '/static/admin'，模板中用 config('app.static_prefix').'/css/app.css'
切勿将不同应用的 JS/CSS 混放在同一 public/static/ 目录下却不加命名区分，容易引发缓存覆盖和版本冲突
Nginx 配置需确保所有域名都指向同一 public/ 目录，否则子域名可能找不到 index.php

上线后部分请求返回 500，日志显示 `ClassNotFoundException: app\admin\controller\Index`

这是最典型的命名空间与目录结构不一致导致的问题。TP6 多应用要求控制器类名严格匹配路径：应用名 + 控制器名，且命名空间必须为 app\{app_name}\controller。一旦服务器大小写敏感（Linux），而本地开发用 Windows，就极易因大小写不符触发类找不到。

实操建议：

检查控制器文件路径是否为 app/admin/controller/Index.php（不是 index.php 或 INDEX.PHP）
确认类声明是 namespace app\admin\controller;，不是 app\Admin\controller 或 app\administrator\controller
清空 runtime/ 下所有缓存（cache/、log/、route/），TP 的路由和类映射缓存在部署后未更新会导致旧路径残留
在生产环境开启 app_debug = false 前，务必先在测试环境用 php think build 生成类映射，避免运行时动态加载失败