模块是Yii2中独立的功能单元，可将应用拆分为后台管理等子系统；创建模块需建立文件夹结构并编写Module.php作为入口。
Yii2 的模块化开发是构建大型、可维护 Web 应用的重要方式。通过模块，你可以将功能拆分，比如后台管理、用户中心、API 接口等独立成一个个子系统，便于团队协作和代码复用。
什么是模块（Module）
在 Yii2 中，模块（Module） 是一个独立的软件单元，包含模型、视图、控制器、配置等完整结构，可以嵌套在应用主体中运行。它类似于一个小型的 Yii 应用，但不能单独运行，必须挂载在主应用或父模块下。
创建一个模块
以创建一个 admin 后台模块 为例：
1. 在项目根目录下创建模块文件夹结构：
modules/
└── admin/
├── Module.php
└── controllers/
└── DefaultController.php
2. 编写模块主类 modules/admin/Module.php：
<?php
namespace app\modules\admin;
class Module extends \yii\base\Module
{
public $controllerNamespace = 'app\modules\admin\controllers';
public function init()
{
parent::init();
// 可在此设置模块级配置
}
}
3. 创建控制器 modules/admin/controllers/DefaultController.php：
<?php
namespace app\modules\admin\controllers;
use yii\web\Controller;
class DefaultController extends Controller
{
public function actionIndex()
{
return $this->render('index');
}
}
4. 添加视图文件 modules/admin/views/default/index.php：
<h1>欢迎进入后台模块</h1> <p>这是 admin 模块的首页。</p>
注册模块到应用
要在主应用中使用该模块，需在应用配置中注册。打开 config/web.php 或 main.php：
'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',
]
];
}
</font>
<p>访问路径为：<strong>/api/v1/user</strong></p>
<H3>模块中的配置与资源管理</H3>
<p>模块可以有自己的行为配置、组件覆盖、资产包（AssetBundle）等。</p>
<ul>
<li>可在模块 <code>init()</code> 中设置默认控制器、布局、权限规则等。</li>
<li>使用 AssetBundle 管理 CSS/JS 资源，避免冲突。</li>
<li>模块可定义自己的数据库连接、缓存前缀等配置。</li>
</ul>
<p>例如设置模块专用布局：</p>
<font color="#006600">
<pre class="brush:php;toolbar:false;">
// 在 Module.php 的 init() 中
$this->layout = 'main';
布局文件放在：views/layouts/main.php
最佳实践建议
- 模块命名清晰，如
backend、api、user等。 - 模块内尽量保持高内聚，避免跨模块强依赖。
- 公共逻辑可抽离成扩展或组件，供多个模块使用。
- 使用 Gii 生成器快速创建模块结构（需配置允许生成模块）。
- 模块间通信可通过事件、服务层或共享组件实现。
基本上就这些。Yii2 模块化让项目结构更清晰，适合中大型项目分工开发。合理规划模块边界，能显著提升代码可维护性。不复杂但容易忽略细节，比如命名空间和自动加载路径。
