ThinkPHP多应用模式需同时满足五条件：安装think-multi-app扩展、定义APP_MULTI_MODULE常量、规范应用目录结构、显式导入子应用路由、绑定入口应用，缺一将导致404或类找不到错误。
ThinkPHP多应用模式不是改个配置就能跑通，必须同时满足扩展安装、目录结构、常量定义、路由导入和入口绑定五个条件。缺一就会出现404、Class not found或App not exists错误。
安装think-multi-app扩展
TP6.x核心不内置多应用能力，必须安装官方扩展，否则所有后续配置都无效。
- 在项目根目录执行：
composer require topthink/think-multi-app - 运行
composer show topthink/think-multi-app确认安装成功 - 检查
config/app.php中'providers'数组是否包含\think\multi\AppServiceProvider::class；未自动注册则手动添加 - 同时运行
composer show topthink/think，确保版本显示为6.x（TP8已移除该功能）
定义APP_MULTI_MODULE常量
这个常量决定框架是否启用多应用路由解析逻辑，只在入口文件中定义才生效，config/app.php里的同名配置完全无效。
- 打开
public/index.php - 在
require __DIR__ . '/../vendor/autoload.php';之前插入：define('APP_MULTI_MODULE', true); - 删除或注释掉
config/app.php中任何'app_multi_module' => false之类的配置行
创建规范的应用目录结构
每个应用必须是app/下的独立子目录，命名严格限定为小写字母与下划线，且必须包含基础文件，否则直接报错。
立即学习“PHP免费学习笔记（深入）”；
- 用命令创建（推荐）：
php think app:create admin（TP8）或php think build admin（TP6） - 验证生成内容：确保存在
app/admin/controller/Index.php、app/admin/route.php、app/admin/config.php -
app/admin/controller/Index.php中命名空间必须为namespace app\admin\controller; -
删除原始的
app/controller目录——这是单应用残留，不删会导致路由误匹配
显式导入子应用路由并绑定入口
子应用的route.php不会自动加载，域名绑定也不走config/app.php的domain_bind，这两步必须手动完成。
- 在全局
route/route.php末尾添加：use think\facade\Route; Route::import('app/admin/route.php', 'admin'); - 第二个参数
'admin'是关键，它把路由规则绑定到对应应用命名空间 - 在
public/index.php中App::run()前做入口绑定，例如：if ($_SERVER['HTTP_HOST'] === 'admin.example.com') { \think\App::bind('admin'); } - 若用子路径访问（如
/admin），需确保default_app设为'index'，并配合URL规则或中间件处理
