ThinkPHP 6.0 多应用模式搭建全流程【实战】

说几个核心判断：ThinkPHP 6.0的多应用模式，并不是改个配置文件就能跑通的。它依赖扩展、目录结构、命名空间和路由加载四者严格对齐。缺了任何一环，等待你的就是App not exists或者Class not found的报错。

扩展安装与基础清理

TP6.0默认并不支持多应用能力，topthink/think-multi-app是一个硬性前置依赖。不装它，目录建得再标准也是白搭。

• 在项目根目录执行：composer require topthink/think-multi-app
• 接下来必须删除app/controller目录及其下的所有文件——只要这个目录存在，框架就会强制降级为单应用模式，哪怕你设置了app_multi_module => true也无效
• 检查config/app.php中是否已启用：'app_multi_module' => true；需要注意的是，较新版本（6.0.2+）已经废弃了auto_multi_app，不用再管它

构建应用目录与命名空间对齐

每个应用必须是app/下的小写子目录，并且命名空间必须与路径完全匹配。大小写或符号上的任何错误，都会导致404或类加载失败。

• 推荐使用命令创建后台应用：php think app:create admin
• 确认生成的结构：应该存在app/admin/controller/Index.php、app/admin/route.php、app/admin/config.php
• 控制器类的命名空间必须是namespace app\admin\controller;，不能写成app\Admin\controller或app\controller
• 视图的默认路径是view/admin/，比如fetch('index')实际读取的是view/admin/index.html

必须显式导入子应用路由

route/route.php是全局入口，但子应用的路由文件并不会自动加载。如果不手动import，app/admin/route.php就只是一纸空文。这一点容易被忽略，但却是实际开发中一个比较常见的踩坑点。

• 在route/route.php中添加：Route::import('admin', 'admin');
• 第二个参数'admin'必须与app/admin目录名完全一致，大小写敏感
• 第一个参数'admin'是路由分组标识，会影响URL前缀，比如访问/admin/dashboard
• app/admin/route.php内部应写Route::get('dashboard', 'Index/dashboard')，避免与主路由发生冲突

配置隔离与运行时分离

ThinkPHP的配置合并机制是“应用级覆盖全局”，而不是“开关式启用”。想让admin应用使用独立数据库，关键不在于打开某个开关，而是要把配置文件放在正确的位置。

• 应用专属配置放在config/admin/目录下，例如config/admin/database.php会自动覆盖全局的database.php
• 运行时目录按应用自动隔离：runtime/admin/和runtime/index/互不干扰
• 如果需要设置默认应用，在config/app.php中添加：'default_app' => 'index'