Yii模块(Modules)

第1步- 在你的项目根目录内创建一个 modules 文件夹。在 modules 文件夹内创建一个名为 admin 的文件夹。这是 admin 模块的基本文件夹。

<?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 文件夹。

<h1>Hello,这是一个自定义模块!</h1> 

我们刚刚创建了 actionGreet 视图。要在模块中使用这个新创建文件，我们还应该配置应用程序。我们应该将模块添加到应用程序的模块属性中。

<?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-xuhuhu.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;
?>

admin/custom/greet

第7步- 现在，键入URL访问： http://localhost:8080/index.php?r=admin/custom/greet，就会看到下面的输出结果了。

要点

模块(Modules)应该 −

• 在大型应用程序中。应划分其功能分成几个应用组。每个应用功能组可以作为一个模块开发。
• 可重复使用。一些常用的功能，如搜索引擎优化管理或博客的管理，可以开发成模块，这样在今后的项目中很容易地重用它们。