多应用模式是ThinkPHP中实现前台、后台、API物理隔离的最优解，需安装topthink/think-multi-app扩展，规范创建admin/api应用目录，配置路由导入或子域名绑定，并独立设置runtime路径与静态资源目录。
当你在ThinkPHP项目中需要把前台、后台、API服务彻底物理隔离，又不想维护多个Git仓库或重复部署框架时，多应用模式就是最干净的解法——它让每个子系统拥有独立控制器、路由、配置和视图，共享同一套核心与vendor，但彼此命名空间不冲突、日志缓存互不干扰。
安装并启用多应用扩展
ThinkPHP 6.x默认不带多应用能力，【必须安装topthink/think-multi-app扩展】，否则后续所有配置都无效。没装这个包，php think app:create命令会报“Command not defined”，app/admin目录建得再规范也进不了路由分发层。
在项目根目录执行：composer require topthink/think-multi-app。
安装后运行composer show topthink/think-multi-app确认有输出；同时检查composer show topthink/think显示版本为6.x（非8.x或3.2.3），因为TP8已移除该能力。
立即学习“PHP免费学习笔记（深入）”；
扩展通常自动注册服务提供器，若未注册，需手动在config/app.php的'providers'数组末尾添加：\think\multi\AppServiceProvider::class。
创建规范的应用目录结构
每个应用必须是app/下的小写、无符号子目录（如admin✅，admin-v2❌，Admin❌），且必须包含controller/、route.php、config.php三要素，缺一即抛App not exists异常。
用命令生成，别手建：php think app:create admin。
立即验证app/admin/是否存在，并检查是否含app/admin/controller/Index.php、app/admin/route.php、app/admin/config.php；若缺失config.php，手动创建并写入：return ['app_namespace' => 'app\admin'];——这一步漏掉会导致Class not found。
再创建API应用：php think app:create api。
配置入口与路由加载
方法一：URL前缀绑定（推荐新手）
在config/route.php末尾追加：Route::import('app/admin/route.php', 'admin'); ——第二个参数'admin'不能省，它把该文件所有路由规则绑定到admin应用命名空间下，否则访问/admin/index/index会404。
同理导入API路由：Route::import('app/api/route.php', 'api');。
方法二：子域名绑定（需Web服务器配合）
在config/app.php中添加domain_bind配置：'domain_bind' => ['admin.localhost' => 'admin', 'api.localhost' => 'api']；Nginx server块中必须设server_name admin.localhost，并确保root指向项目根目录（不是public/），否则请求被重写进public/index.php，multiApp模式直接失效。
【multiApp模式下入口文件必须是项目根目录的index.php，不是public/index.php】。若你还在用public/index.php启动，所有子应用请求都会跳过应用识别逻辑。
隔离运行时与静态资源
第一步：为admin应用单独设置runtime路径，在app/admin/config/app.php中添加：'runtime_path' => '../runtime/admin/'。
第二步：同理为api应用设置：'runtime_path' => '../runtime/api/'。
第三步：避免静态资源混用，在app/admin/config/app.php中指定view_replace_str：'__STATIC__' => '/static/admin'；然后把admin专属CSS/JS放进public/static/admin/目录。
这三步做完，admin和api的日志、缓存、模板编译文件就完全分开，上线时删一个应用的runtime不会影响另一个。
