ThinkPHP 6.0 多应用模式搭建全流程【实战】
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境,可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
ThinkPHP6.0多应用模式需安装topthink/think-multi-app扩展,删除app/controller目录,设置app_multi_module为true。应用目录必须为app/下小写子目录,命名空间与路径一致。需在全局路由中手动导入子应用路由,应用配置放在config/应用名/目录下自动覆盖全局配置。
说几个核心判断:ThinkPHP 6.0的多应用模式,并不是改个配置文件就能跑通的。它依赖扩展、目录结构、命名空间和路由加载四者严格对齐。缺了任何一环,等待你的就是App not exists或者Class not found的报错。

扩展安装与基础清理
TP6.0默认并不支持多应用能力,topthink/think-multi-app是一个硬性前置依赖。不装它,目录建得再标准也是白搭。
- 在项目根目录执行:
composer require topthink/think-multi-app - 接下来必须删除
app/controller目录及其下的所有文件——只要这个目录存在,框架就会强制降级为单应用模式,哪怕你设置了app_multi_module => true也无效 - 检查
config/app.php中是否已启用:'app_multi_module' => true;需要注意的是,较新版本(6.0.2+)已经废弃了auto_multi_app,不用再管它
构建应用目录与命名空间对齐
每个应用必须是app/下的小写子目录,并且命名空间必须与路径完全匹配。大小写或符号上的任何错误,都会导致404或类加载失败。
- 推荐使用命令创建后台应用:
php think app:create admin - 确认生成的结构:应该存在
app/admin/controller/Index.php、app/admin/route.php、app/admin/config.php - 控制器类的命名空间必须是
namespace app\admin\controller;,不能写成app\Admin\controller或app\controller - 视图的默认路径是
view/admin/,比如fetch('index')实际读取的是view/admin/index.html
必须显式导入子应用路由
route/route.php是全局入口,但子应用的路由文件并不会自动加载。如果不手动import,app/admin/route.php就只是一纸空文。这一点容易被忽略,但却是实际开发中一个比较常见的踩坑点。
- 在
route/route.php中添加:Route::import('admin', 'admin'); - 第二个参数
'admin'必须与app/admin目录名完全一致,大小写敏感 - 第一个参数
'admin'是路由分组标识,会影响URL前缀,比如访问/admin/dashboard app/admin/route.php内部应写Route::get('dashboard', 'Index/dashboard'),避免与主路由发生冲突
配置隔离与运行时分离
ThinkPHP的配置合并机制是“应用级覆盖全局”,而不是“开关式启用”。想让admin应用使用独立数据库,关键不在于打开某个开关,而是要把配置文件放在正确的位置。
- 应用专属配置放在
config/admin/目录下,例如config/admin/database.php会自动覆盖全局的database.php - 运行时目录按应用自动隔离:
runtime/admin/和runtime/index/互不干扰 - 如果需要设置默认应用,在
config/app.php中添加:'default_app' => 'index'
Adobe Acrobat Pro 是面向办公、法务、财务、教育及出版用户的专业PDF处理软件,可在Mac上创建、编辑、转换、合并和保护文档,并提供OCR文字识别、表单、批注、内容比较、敏感信息遮盖及电子签名功能。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核,支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换,并可通过账户在多台设备之间同步项目。
AutoCAD 是 Autodesk 推出的专业计算机辅助设计软件,Windows 版支持精确二维绘图、三维实体与曲面建模、图纸标注、布局发布和任务自动化,并包含多套行业专业化工具组合,适用于建筑、机械、电气、工程建设及制造设计人员。
Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案,可在 Windows 中创建、编辑、转换、比较、整理和保护文档,并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力,
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。













