Yii Module是共享主应用配置的功能分区，ThinkPHP多应用是隔离配置的物理分家；前者轻量高效适合后台拆分，后者灵活独立适合多租户或子域名部署。
Yii 的模块化不是“多应用”，ThinkPHP 的多应用也不是“模块化”——两者底层机制完全不同，强行类比会踩坑。
Yii 的 Module 是运行时可插拔的子系统
Yii 的 Module 本质是独立注册的控制器容器，它共享主应用的 components（如 db、cache），但拥有自己的 controllers、views、models 和路由前缀。一个典型用法是：
- 在
config/web.php中注册：'modules' => ['admin' => ['class' => 'app\modules\admin\Module']] - 对应目录为
modules/admin/Module.php，其中init()可覆盖组件行为 - 访问路径自动带前缀：
/admin/user/index→ 路由到modules/admin/controllers/UserController
关键点：Module 不启动新应用生命周期，不隔离 $_ENV 或 Yii::$app 实例；它依赖主应用配置，无法单独配置数据库连接或中间件栈。
ThinkPHP 的多应用是独立入口 + 隔离配置
ThinkPHP 的 app 目录下可并列多个子目录（如 admin/、api/），每个都是完整 MVC 结构，通过 public/admin.php 等不同入口文件加载对应应用。它实际做了三件事：
立即学习“PHP免费学习笔记（深入）”；
- 入口文件指定
APP_PATH（如define('APP_PATH', __DIR__ . '/../app/admin/');） - 每个子应用有独立的
config/目录，database.php可完全不一样 - 路由不共享：访问
/admin/不等于/下的admin模块，而是全新请求上下文
这意味着：两个子应用可使用不同数据库、不同中间件、甚至不同日志驱动 —— 但也带来重复加载、缓存键冲突、Session 共享困难等问题。
为什么不能把 Yii Module 当成 ThinkPHP 多应用来用？
常见误操作是试图让一个 Yii Module 连接独立数据库或启用独立 RBAC 配置。结果是：
-
Module::getDb()默认返回Yii::$app->db，不是 Module 自己的 - 想换 DB？得手动 new \yii\db\Connection 并在 Module 内管理，失去 ActiveRecord 自动绑定能力
- RBAC 配置写在
main.php，Module 无法覆盖authManager组件定义 - 生成 URL 时
Url::to(['admin/user/index'])仍走主应用路由规则，无法强制跳转到另一套域名
换句话说：Yii Module 是“功能分区”，ThinkPHP 多应用是“物理分家”。前者轻量、高效、适合后台功能拆分；后者重载、灵活、适合多租户或前后端分离部署。
选型时真正该盯住的三个点
别只看文档里“都支持多入口”，要看实际约束：
- 是否需要各应用使用不同数据库账号？→ ThinkPHP 多应用可直接配，Yii Module 必须改代码绕过组件复用
- 是否要求各应用独立部署（比如
admin.example.com和api.example.com）？→ ThinkPHP 多应用靠不同入口文件天然支持，Yii 得配合 Nginx 重写 + 多个web/目录 - 是否已有大量通用 Model/Service 需跨应用复用？→ Yii Module 天然共享命名空间和类自动加载，ThinkPHP 多应用需手动调整
composer.jsonautoload 或抽成独立包
复杂点在于：一旦用了 Yii Module 做权限隔离，后期想拆成独立子域名，就得重写路由层和认证逻辑；而 ThinkPHP 多应用早期没规划好 common/ 目录结构，后期复用模型反而更麻烦。
