启用ThinkPHP多应用模式必须安装topthink/think-multi-app扩展,适用于TP6.x;需手动注册AppServiceProvider;推荐安装think-view以支持模板语法;还需删除单应用目录、用命令创建应用、确保PHP≥7.1。

启用 ThinkPHP 多应用模式,核心前提是必须安装官方扩展 topthink/think-multi-app。这个扩展不是可选组件,而是整个多应用机制的底层支撑——不装它,后续所有配置、目录创建、域名绑定都无效。
必须安装的扩展:think-multi-app
这是唯一强制依赖的扩展,适用于 ThinkPHP 6.x 全系列(注意:TP8 已移除原生多应用能力,仅 TP6 支持该扩展)。
- 在项目根目录执行:
composer require topthink/think-multi-app - 安装后检查
config/app.php中'providers'数组末尾是否已自动加入:\think\multi\AppServiceProvider::class - 若未自动注册(常见于精简版或手动修改过配置),需手动添加,否则应用识别完全失效
推荐配套安装的扩展:think-view
如果你要用 return view() 渲染模板,默认 PHP 原生引擎功能有限,且不支持 think-template 语法(如 {:url()}、{volist} 等)。
- 执行:
composer require topthink/think-view - 安装后会自动引入
think-template,控制器中即可正常使用视图功能 - 不装此扩展时调用
view()会直接报错
环境与结构准备要点
扩展只是基础,还需配合正确操作才能生效:
立即学习“PHP免费学习笔记(深入)”;
- 删除默认的
app/controller等单应用残留目录(TP6 会据此判断是否为单应用模式) - 用命令创建应用目录:
php think build index、php think build admin等 - 确保 PHP 版本匹配:TP6 要求 PHP ≥ 7.1;若混用 TP8 相关生态(如 think-swoole),需特别注意版本兼容性
多应用不是改个配置就能跑通的事,扩展、目录、命令、环境四者缺一不可。



















