ThinkPHP切换单/多应用模式需同步修改APP_MULTI_MODULE常量（入口文件定义）与目录结构：设false并移除app/子目录为单应用；设true并恢复子目录结构为多应用，否则导致路由失效、模块找不到等问题。
如何在 ThinkPHP 中切换单应用与多应用模式
ThinkPHP 的应用模式不是靠“开关”一键切换，而是由 APP_MULTI_MODULE 配置项 + 目录结构共同决定的。改配置不改目录，或改目录不改配置，都会导致路由失效、模块找不到、App::getModule() 返回空等现象。
APP_MULTI_MODULE 配置值怎么设才生效
这个常量控制框架是否启用多应用模式，默认为 true（即多应用）。但注意：它只在入口文件中定义才有效，且必须在加载框架前定义。
- 切到单应用模式：在
public/index.php中，引入框架前 加上define('APP_MULTI_MODULE', false); - 切回多应用模式：删掉这行，或显式设为
true - 如果在
config/app.php里改'app_multi_module' => false，完全无效——这是常见误操作 - 该配置不影响已存在的目录结构，只影响框架对
route和module的解析逻辑
目录结构必须同步调整，否则 404 或跳错模块
多应用模式下，每个应用是独立目录（如 app/admin、app/api），而单应用模式下，所有控制器应放在 app/controller 下，且不能有二级模块目录。
- 从多应用切单应用：需把
app/admin/controller等路径下的控制器移到app/controller，并删除app/admin等子目录 - 同时检查路由定义——多应用模式下
admin/index是合法路由，单应用模式下必须写成index或显式绑定到controller@index - 若保留
app/admin目录但关闭APP_MULTI_MODULE，框架仍会尝试按多应用规则解析，结果是app/admin被忽略，控制器找不到
路由和中间件行为差异容易被忽略
两种模式下，Route::rule() 的匹配路径前缀、middleware 的注册作用域、甚至 Url::build() 生成的 URL 格式都不同。
立即学习“PHP免费学习笔记（深入）”；
- 多应用模式下，
Url::build('index')默认生成/admin/index（当前应用前缀自动拼接）；单应用下直接生成/index - 中间件若在
app/admin/middleware.php定义，多应用模式下只对admin应用生效；单应用模式下这个文件根本不会被加载 - 使用
think\Route手动添加规则时，多应用模式需注意['app' => 'admin']这类约束参数，单应用模式下这些参数无意义，还可能引发未定义键警告
最麻烦的不是改配置，而是控制器命名空间、路由绑定、模板路径、配置加载顺序这些隐性依赖——它们在两种模式下默认行为不同，但错误往往不报错，只表现为页面空白或跳转错乱。
