ThinkPHP多应用配置需安装think-multi-app扩展、定义APP_MULTI_MODULE常量、创建规范子目录结构、域名绑定应用及显式导入各应用路由。
如果您尝试在ThinkPHP项目中划分前台、后台与API等独立子系统，但访问/admin或/api路径时出现404或控制器未找到错误，则可能是多应用模式未正确配置。以下是实现多应用模式的具体配置方法：
一、确认框架版本并安装多应用扩展
ThinkPHP 6.x核心包默认不内置多应用功能，必须通过Composer安装官方扩展才能启用完整支持；若使用ThinkPHP 8（如think-swoole生态），则已移除该能力，配置将完全无效。
1、在项目根目录执行命令安装扩展：composer require topthink/think-multi-app。
2、检查是否自动注册ThinkMultiAppServiceProvider；若未注册，需手动在config/app.php的'providers'数组中添加：\think\multi\AppServiceProvider::class。
立即学习“PHP免费学习笔记（深入）”；
3、运行composer show topthink/think确认版本为6.x，非8.x或3.2.3等旧版。
二、启用多应用模式并设置常量
APP_MULTI_MODULE常量必须在入口文件加载框架前定义，config/app.php中的同名配置项完全无效；该常量控制路由解析逻辑，不匹配会导致模块找不到或跳转错乱。
1、打开public/index.php文件，在require __DIR__ . '/../vendor/autoload.php';之前插入：define('APP_MULTI_MODULE', true);。
2、删除或注释掉config/app.php中任何形如'app_multi_module' => false的配置行，避免干扰。
3、确保app/目录下不存在空置或命名非法的子目录（如含大写字母、短横线或中文），否则触发InvalidArgumentException。
三、创建应用目录结构并初始化内容
每个应用必须是app/下的独立小写子目录，且需包含controller/、route.php和config.php基础结构；缺失任一文件将导致App not exists: admin异常。
1、使用命令行创建admin应用：php think app:create admin。
2、手动验证生成目录结构：确认存在app/admin/controller/Index.php、app/admin/route.php及app/admin/config.php。
3、检查app/admin/controller/Index.php类声明是否为namespace app\admin\controller;，命名空间必须严格匹配应用名与目录路径。
四、配置域名绑定与应用入口映射
TP6+多应用模式不支持config/app.php中domain_bind配置，该字段被忽略；真正生效的方式是在入口文件中读取$_SERVER['HTTP_HOST']并调用\think\App::bind()显式绑定应用名。
1、在public/index.php中require autoload.php之后、App::run()之前添加判断逻辑：
2、若请求域名为admin.example.com，则绑定admin应用：if ($_SERVER['HTTP_HOST'] === 'admin.example.com') { \think\App::bind('admin'); }。
3、若需支持多个域名，可叠加类似判断，但每条绑定语句必须在App::run()前执行，且不可重复绑定。
五、加载各应用独立路由文件
全局route/route.php不会自动加载子应用路由，必须使用Route::import()显式引入；否则即使应用绑定成功，路由仍 fallback 到app/route.php，导致/admin/login无法命中app/admin/route.php中定义的规则。
1、打开route/route.php（即全局路由入口文件）。
2、添加导入语句加载admin应用路由：Route::import('admin', 'admin');。
3、添加导入语句加载api应用路由：Route::import('api', 'api');。
4、确保app/admin/route.php以use think\facade\Route;开头，并包含实际路由定义，如Route::get('login', 'index/login');。
