如何配置ThinkPHP多应用模式及模块化多应用开发方案？

本文共计976个文字，预计阅读时间需要4分钟。

ThinkPHP多应用模式并非仅靠更改配置就能启动，必须同时满足目录结构、命名空间、路由导入和自动加载四个方面条件，缺一不可。

app 目录下没建对子目录，AppNotFoundException 就会直接报给你看

框架不会自动创建 app/admin 或 app/api 这类目录——你得手动建，或用命令行工具生成。否则即使配置全开，请求进来也找不到控制器。

• 执行 php think app:create admin（TP6.1+）或 php think build admin（旧版），确保 app/admin/ 下有 controller/、model/、view/、config/ 等标准子目录
• 模块名必须是合法 PHP 类名：只含字母、数字、下划线，且不能以数字开头；admin 可以，1admin 或 user-api 会失败
• 删掉原始的 app/controller 目录——这是单应用标志，不删会导致框架误判为单应用模式

config/app.php 里只设 'app_multi_module' => true 不够

这个配置只是“允许多模块”，但真正启用多应用识别，还得靠 'auto_multi_app' => true 和 'app_namespace' => 'app' 配合。