模块是Yii2中独立的功能单元，可将应用拆分为后台管理等子系统；创建模块需建立文件夹结构并编写Module.php作为入口。
Yii2 的模块化开发是构建大型、可维护 Web 应用的重要方式。通过模块，你可以将功能拆分，比如后台管理、用户中心、API 接口等独立成一个个子系统，便于团队协作和代码复用。
什么是模块（Module）
在 Yii2 中，模块（Module） 是一个独立的软件单元，包含模型、视图、控制器、配置等完整结构，可以嵌套在应用主体中运行。它类似于一个小型的 Yii 应用，但不能单独运行，必须挂载在主应用或父模块下。
创建一个模块
以创建一个 admin 后台模块 为例：
1. 在项目根目录下创建模块文件夹结构：
modules/
└── admin/
├── Module.php
└── controllers/
└── DefaultController.php
2. 编写模块主类 modules/admin/Module.php：
3. 创建控制器 modules/admin/controllers/DefaultController.php：
render('index');
}
}
4. 添加视图文件 modules/admin/views/default/index.php：
欢迎进入后台模块
这是 admin 模块的首页。
注册模块到应用
要在主应用中使用该模块，需在应用配置中注册。打开 config/web.php 或 main.php：
优六系统(全称:优六企服系统)是在Util6MIS基础上组合CMS等插件及子系统的综合信息化管理系统。 Util6MIS(软著全称:优六信息化管理框架系统)是一款免费的通用信息化快速开发框架，该框架可快速集成各类系统开发。 系统后台采用.NET6 + Layui作为UI支撑，操作界面简洁，项目结构清晰，功能模块化设计，支撑框架轻量高效，代码层级分离，注释完整，可快速重构，提高开发效率。
'components' => [ ... ],
'modules' => [
'admin' => [
'class' => 'app\modules\admin\Module',
],
],
完成后，访问：
http://your-site/index.php?r=admin
或启用美化 URL 后：
http://your-site/admin
模块的嵌套与路由
模块支持多层嵌套。例如创建一个 v1 API 模块 作为子模块：
modules/
└── api/
├── Module.php
└── modules/
└── v1/
├── Module.php
└── controllers/
└── UserController.php
在 api/Module.php 中注册子模块：
public function init()
{
parent::init();
$this->modules = [
'v1' => [
'class' => 'app\modules\api\modules\v1\Module',
]
];
}
访问路径为：/api/v1/user
模块中的配置与资源管理
模块可以有自己的行为配置、组件覆盖、资产包（AssetBundle）等。
- 可在模块
init()中设置默认控制器、布局、权限规则等。 - 使用 AssetBundle 管理 CSS/JS 资源，避免冲突。
- 模块可定义自己的数据库连接、缓存前缀等配置。
例如设置模块专用布局：
// 在 Module.php 的 init() 中 $this->layout = 'main';
布局文件放在：views/layouts/main.php
最佳实践建议
- 模块命名清晰，如
backend、api、user等。 - 模块内尽量保持高内聚，避免跨模块强依赖。
- 公共逻辑可抽离成扩展或组件，供多个模块使用。
- 使用 Gii 生成器快速创建模块结构（需配置允许生成模块）。
- 模块间通信可通过事件、服务层或共享组件实现。
基本上就这些。Yii2 模块化让项目结构更清晰，适合中大型项目分工开发。合理规划模块边界，能显著提升代码可维护性。不复杂但容易忽略细节，比如命名空间和自动加载路径。
