ThinkPHP6如何开启多应用模式_ThinkPHP6开启多应用模式设置【教程】-ThinkPHP-PHP中文网

thinkphp 6 多应用模式需安装 think-multi-app 扩展、用 php think build 创建子应用、同步配置 app_namespace 和 app_multi、显式导入子应用路由并指定应用名，否则将出现类找不到或应用未找到错误。

thinkphp6如何开启多应用模式_thinkphp6开启多应用模式设置【教程】

ThinkPHP 6 开启多应用模式不是改个配置就能跑通的事——app_multi 或 auto_multi_app 设为 true 只是第一步，目录结构、命名空间、路由加载、CLI 命令目标这四块不配齐，90% 的人会卡在 Class not found 或 AppNotFoundException。

必须安装 `think-multi-app` 扩展

TP6 核心包默认不带多应用能力，composer require topthink/think-multi-app 是硬性前提。没装这个，php think build admin 会报错 Command "build" is not defined；app/ 下建了 admin/ 目录也白搭，框架压根不识别。

扩展安装后会自动注册多应用中间件，无需手动添加
确认是否装成功：运行 composer show topthink/think-multi-app，有输出即有效
别用 think-swoole 或 TP8 生态替代——它们已移除多应用支持，composer show topthink/think 必须显示 6.x 版本

`php think build` 创建子应用目录，别手建

手动在 app/ 下新建 admin/ 文件夹，再复制 controller、route.php 等，极易漏掉命名空间声明或目录权限问题。官方推荐用命令生成：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

php think build admin —— 自动生成 app/admin/controller、app/admin/route.php、app/admin/config/ 等完整骨架
每个子应用名必须小写、无短横线（admin ✅，admin-v2 ❌）
build 命令不会覆盖已有文件，但也不会补全缺失的 config/app.php，需检查子应用内是否含该文件

`app_namespace` 和 `app_multi` 必须同步改

只改 config/app.php 里的 'app_multi' => true 不够。控制器类自动加载失败（比如访问 /admin/index/index 报 Class 'app\admin\controller\Index' not found），大概率是 app_namespace 还卡在默认的 app\controller。

把 'app_namespace' => 'app'（不是 app\controller）
'default_app' => 'index' 可设可不设，但没设时 URL 必须带应用名前缀，否则直接 404
'domain_bind' 要配合 Web 服务器生效：Apache 需配 .htaccess，Nginx 需在 server 块里加 server_name admin.localhost

子应用路由必须显式 `Route::import()`

route/route.php 是全局入口，但子应用自己的 app/admin/route.php 不会自动加载。不写 Route::import()，那个文件就是死的，控制器再全也没用。

在 route/route.php 末尾加：Route::import('app/admin/route.php', 'admin');
第二个参数 'admin' 是关键，它把路由规则绑定到 admin 应用命名空间下
多个子应用就写多行，顺序无关，但路径字符串必须准确（注意斜杠方向和大小写）

最容易被忽略的是：子应用的 config/database.php 里数据库配置不会继承全局 config，得单独写；而 CLI 命令如 php think make:controller 默认仍往 app/controller 写，必须加 --app=admin 参数指定目标。这些点不处理，开发一半才发现模型调不通、命令生成错目录，返工成本远高于初始化时多敲几行。