> 模塊是一個有自己的模型，視圖，控制器以及其它模塊的實體。這實際上是在應用程序內的應用程序。 [TOC] #### 第1步- 在你的項目根目錄內創建一個 modules 文件夾。在 modules 文件夾內創建一個名為 admin 的文件夾。這是 admin 模塊的基本文件夾。 #### 第2步 - 在 admin 文件夾里邊，使用以下代碼來創建 Admin.php 文件。 ~~~ <?php namespace app\modules\admin; class Admin extends \yii\base\Module { public function init() { parent::init(); } } ?> ~~~ 我們剛剛創建了一個模塊類。它位于模塊根路徑下。每一次模塊被訪問時，將創建對應的模塊類的一個實例。init()函數用于初始化模塊的屬性。 #### 第3步 - 現在，在 admin文件夾內添加兩個目錄- controllers 和 views。添加 CustomController.php 文件到控制器的文件夾中。 ~~~ <?php namespace app\modules\admin\controllers; use yii\web\Controller; class CustomController extends Controller { public function actionGreet() { return $this->render('greet'); } } ?> ~~~ 當創建一個模塊，慣例是把控制器類到模塊根路徑的 controllers 目錄。我們剛才定義的actionGreet函數，只返回一個 greet 視圖。 在模塊中視圖應該放在模塊基本路徑的 views 文件夾中。如果視圖是由控制器呈現，那么它們應位于對應于該控制器ID的文件夾中。將 custom 文件夾添加到 views 文件夾。 #### 第4步 - 在 custom 目錄里創建一個名為 greet.php 文件并使用下面的代碼。 ~~~ <h1>Hello,這是一個自定義模塊!</h1> ~~~ 我們剛剛創建了 actionGreet 視圖。要在模塊中使用這個新創建文件，我們還應該配置應用程序。我們應該將模塊添加到應用程序的模塊屬性中。 #### 第5步 - 修改 config/web.php 文件，如下。 ~~~ <?php $params = require(__DIR__ . '/params.php'); $config = [ 'id' => 'basic', 'basePath' => dirname(__DIR__), 'bootstrap' => ['log'], 'components' => [ 'request' => [ // !!! insert a secret key in the following (if it is empty) - this is //required by cookie validation 'cookieValidationKey' => 'Yia-yiibai.com', ], 'cache' => [ 'class' => 'yii\caching\FileCache', ], 'user' => [ 'identityClass' => 'app\models\User', 'enableAutoLogin' => true, ], 'errorHandler' => [ 'errorAction' => 'site/error', ], 'mailer' => [ 'class' => 'yii\swiftmailer\Mailer', // send all mails to a file by default. You have to set // 'useFileTransport' to false and configure a transport // for the mailer to send real emails. 'useFileTransport' => true, ], 'log' => [ 'traceLevel' => YII_DEBUG ? 3 : 0, 'targets' => [ [ 'class' => 'yii\log\FileTarget', 'levels' => ['error', 'warning'], ], ], ], 'db' => require(__DIR__ . '/db.php'), ], 'modules' => [ 'admin' => [ 'class' => 'app\modules\admin\Admin', ], ], 'params' => $params, ]; if (YII_ENV_DEV) { // configuration adjustments for 'dev' environment $config['bootstrap'][] = 'debug'; $config['modules']['debug'] = [ 'class' => 'yii\debug\Module', ]; $config['bootstrap'][] = 'gii'; $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', ]; } return $config; ?> ~~~ 模塊的控制器路由必須使用模塊ID開始，后面控制器ID和動作ID。 #### 第6步 - 如要在應用程序運行 actionGreet，應該使用下面的路由 ~~~ admin/custom/greet ~~~ 在這里，admin 就是一個模塊ID，custom 是控制器ID和 greet 就是一個動作ID。 第7步- 現在，鍵入URL訪問： http://localhost:8080/index.php?r=admin/custom/greet ,就會看到下面的輸出結果了。  # 要點 模塊(Modules)應該 ? 在大型應用程序中。應劃分其功能分成幾個應用組。每個應用功能組可以作為一個模塊開發。 可重復使用。一些常用的功能，如搜索引擎優化管理或博客的管理，可以開發成模塊，這樣在今后的項目中很容易地重用它們。