Yii2模块化怎么开发_Yii2框架模块化开发与项目结构-php教程-PHP中文网

Yii2模块化怎么开发_Yii2框架模块化开发与项目结构

絕刀狂花

发布： 2025-10-01 09:13:02

原创

937人浏览过

模块是Yii2中独立的功能单元，可将应用拆分为后台管理等子系统；创建模块需建立文件夹结构并编写Module.php作为入口。

yii2模块化怎么开发_yii2框架模块化开发与项目结构

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