ThinkPHP 6.0单应用与多应用目录结构有何区别【架构】

单应用与多应用是ThinkPHP 6.0中两种本质不同的目录结构：单应用将所有代码置于app/下，命名空间统一为app；多应用则要求app/下每个小写子目录（如admin）对应独立应用，命名空间、目录名、路由导入三者必须严格一致，并需安装think-multi-app扩展及正确定义APP_MULTI_MODULE常量。

单应用和多应用在ThinkPHP 6.0中不是“配置开关一按就切换”的功能，而是两种根本不同的目录组织逻辑——结构不对，代码就加载不了，路由就匹配不上，哪怕只错一个字母。

单应用：app下直接放业务代码

默认安装后就是单应用模式。整个项目只有一个“应用”，所有业务代码都堆在app/目录下：

• app/controller/ 存控制器，命名空间统一为 appcontroller
• app/model/ 存模型，命名空间为 appmodel
• app/view/ 存模板，默认路径就是 view/
• app/ 根目录下还可能有 BaseController.php、provider.php 等基础类和配置文件
• 所有配置从 config/ 加载，路由全写在 route/route.php 里

多应用：app下是应用集合，每个子目录是一个独立应用

启用多应用后，app/ 不再直接放控制器，而是变成“应用容器”——每个子目录代表一个完整应用：

• app/admin/ 是后台应用，含自己的 controller/、model/、view/、config/、route/
• app/api/ 是接口应用，结构同上，视图可为空，配置可覆盖全局
• 控制器命名空间必须与目录严格对应，比如 app/admin/controller/Index.php 的命名空间只能是 appadmincontroller
• 模板默认路径变为 view/admin/、view/api/，不再共用 view/
• runtime/ 下会自动生成对应子目录（如 runtime/admin/）用于隔离缓存与日志

关键差异点：三处必须同步对齐

多应用能跑起来，靠的是目录名、命名空间、路由导入三者完全一致：

立即学习“PHP免费学习笔记（深入）”；

• 目录名必须全小写，app/Admin 或 app/user_v2 都无效，只认 app/admin
• 命名空间不能带大写或下划线，appAdmincontroller 会加载失败，必须是 appadmincontroller
• 子应用路由不会自动加载，必须在 route/route.php 中显式写：Route::import('admin', 'admin')，第二个参数必须与目录名一字不差

入口与配置层面的硬性区别

多应用不是改个 config 就行，它依赖底层机制：

• 必须安装 topthink/think-multi-app 扩展，否则框架根本不识别多应用目录
• 必须删除 app/controller 目录，只要它存在，框架强制降级为单应用
• APP_MULTI_MODULE 常量必须在 public/index.php 最开头定义，写在 config 里无效
• 多应用支持多个入口文件（如 admin.php），但单应用只有 index.php 一个入口