必须配置多应用模式：一、安装think-multi-app扩展并启用app_multi_module；二、创建隔离应用目录并规范命名空间；三、在config/route.php中import各应用路由；四、在public/index.php中用HTTP_HOST手动bind应用；五、为各应用独立配置runtime_path和静态资源路径。
如果您在ThinkPHP项目中需要将前台、后台、API等业务模块物理隔离并独立运行，则必须正确配置多应用模式。以下是针对TP6.1+版本的进阶配置实战步骤：
一、安装扩展并启用多应用支持
ThinkPHP 6.1+默认不内置多应用能力，需通过官方扩展注入该功能。此步骤是整个多应用架构的基础前提，缺失将导致后续所有配置失效。
1、在项目根目录执行命令安装扩展：composer require topthink/think-multi-app。
2、确认config/app.php中已存在或手动添加配置项：'app_multi_module' => true。
立即学习“PHP免费学习笔记（深入）”；
3、检查服务提供器是否注册：若未自动注册，需在config/app.php的'providers'数组中追加：\think\multi\AppServiceProvider::class。
4、执行服务发现命令，确保扩展被框架识别：php think service:discover。
二、构建严格隔离的应用目录结构
多应用模式下，app目录必须按子系统拆分为独立命名的子目录，且每个子目录须具备完整结构，否则控制器类无法自动加载，将直接抛出Class not found异常。
1、使用命令创建admin应用：php think app:create admin。
2、验证app/admin/目录是否存在，并包含controller/、model/、view/、config/、route.php等标准子项。
3、为API服务创建独立应用：php think app:create api。
4、检查各应用命名空间是否统一：例如app/admin/config/app.php中必须设置'app_namespace' => 'app\admin'，不可保留默认的app\controller。
三、配置应用级路由分发机制
TP6多应用不支持路径自动识别应用名，必须通过显式导入方式将各应用路由挂载到全局路由入口，否则请求永远只会进入默认应用的route.php。
1、编辑config/route.php，在return数组中添加：Route::import('admin', 'admin');。
2、为API应用添加对应导入：Route::import('api', 'api');。
3、进入app/admin/route.php，确认首行包含：use think\facade\Route;。
4、在app/admin/route.php中定义专属路由，例如：Route::get('dashboard', 'index/dashboard');。
四、实现域名绑定到指定应用
TP6多应用模式本身不支持config/app.php中的domain_bind配置，该配置在多应用环境下被完全忽略。必须在public/index.php入口文件中通过HTTP_HOST手动绑定，且绑定操作必须位于App::run()之前。
1、打开public/index.php，在require __DIR__ . '/../vendor/autoload.php';之后、App::run()之前插入判断逻辑。
2、绑定admin子域名：if ($_SERVER['HTTP_HOST'] === 'admin.example.com') { \think\App::bind('admin'); }。
3、绑定API子域名：if ($_SERVER['HTTP_HOST'] === 'api.example.com') { \think\App::bind('api'); }。
4、确保每个应用的route.php文件均被实际加载：可在app/admin/route.php开头添加dump('admin route loaded');进行调试验证。
五、隔离运行时与静态资源路径
多应用共用runtime和public/static会导致日志混杂、缓存冲突、静态资源404等问题。必须为每个应用分配独立路径，避免交叉污染。
1、在app/admin/config/app.php中设置：'runtime_path' => '../runtime/admin/'。
2、在app/api/config/app.php中设置：'runtime_path' => '../runtime/api/'。
3、禁用static()函数自动推导：模板中改用绝对路径引用资源，例如：<link href="/static/admin/css/app.css" rel="stylesheet">。
4、在Nginx配置中确保所有请求统一指向public/目录，且runtime目录具有写入权限：chmod -R 755 runtime/。
