ThinkPHP5多应用怎么部署_ThinkPHP5多应用模式配置教程【架构】-ThinkPHP-PHP中文网

thinkphp 5 不原生支持多应用模式，所谓“tp5 多应用”实为误传或强行模拟；真正稳定可维护的多应用必须升级到 thinkphp 6 并安装 topthink/think-multi-app 扩展。

thinkphp5多应用怎么部署_thinkphp5多应用模式配置教程【架构】

ThinkPHP 5 不原生支持多应用模式，所谓“TP5 多应用”实际是误传或强行模拟，真要跑多个独立应用，必须升级到 ThinkPHP 6 + topthink/think-multi-app 扩展——这是唯一稳定、可维护的路径。

TP5 的核心设计就是单应用结构：app 目录下只允许一个 controller 根目录，没有 app_multi_module、auto_multi_app 等配置项，也没有应用级自动加载命名空间隔离机制。所有“TP5 多应用教程”本质只有两种做法：

手动复制多套入口文件（如 admin.php、api.php），各自定义 APP_NAME 和 APP_PATH，但共用同一套 app/ 目录 → 实际仍是单应用，只是靠入口硬切，路由/配置/模型全混在一起，极易冲突
在 app/ 下建 admin/、api/ 子目录，再通过自定义路由规则匹配前缀 → 框架根本不识别这些目录为“应用”，控制器类自动加载失败，Class not found 是常态

这两种方式在 TP5.1.x 或 TP5.0.x 上都不可靠，升级 PHP 8+ 后基本直接报错。

不是“改配置就能用”，而是必须完成以下四点，缺一不可：

执行 composer require topthink/think-multi-app，确认扩展已安装且未被 autoload-dev 错误排除
检查 config/app.php 是否含 'app_multi_module' => true 和 'auto_multi_app' => true；若缺失，手动补全
删掉原始的 app/controller/ 目录（TP5 遗留的单应用标志，不删会导致框架拒绝进入多应用模式）
用命令创建应用：php think app:create admin，验证生成的 app/admin/controller/ 下有合法命名空间声明（如 namespace app\admin\controller;）

做完这四步后，runtime/ 缓存必须清空：php think clear:all，否则旧路由缓存会掩盖配置生效情况。

ThinkPHP5.1企业站点快速开发

下载

config/app.php 中的 'domain_bind' => ['admin.example.com' => 'admin'] 仅用于 URL 解析阶段，它不会改变应用上下文初始化逻辑。真正起作用的是入口文件：

为每个域名建独立入口：如 public/admin.php，内容与 index.php 几乎一致，但必须包含 define('APP_NAME', 'admin');
Nginx 的每个 server 块必须显式指向对应入口：fastcgi_param SCRIPT_FILENAME $document_root/admin.php;
禁止使用 try_files $uri $uri/ /index.php?$query_string; 这类兜底规则——它会让所有域名都落到 index.php，破坏应用隔离

漏掉任一入口文件或 Nginx 配置错位，就会出现“域名能解析，但控制器找不到”或“静态资源 404”这类典型问题。

TP6 多应用的配置加载顺序是：全局配置 → 应用级配置（app/admin/config/）→ 环境配置（.env）。这意味着：

app/admin/config/database.php 中的 'hostname'、'database' 会完全覆盖全局 config/database.php 的同名项
但中间件、事件监听器、命令行指令等仍需在 app/admin/command.php 或 app/admin/middleware.php 中单独注册，不会自动继承
公共资源（如上传路径、日志目录）建议按应用分目录：runtime/log/admin/、runtime/log/api/，避免交叉写入损坏