Yii - 创建事件

本章将介绍如何在 Yii 中创建事件。为了演示事件的实际应用，我们需要一些数据。

准备数据库

步骤 1 - 创建一个新的数据库。数据库可以通过以下两种方式创建。

• 在终端运行 mysql -u root –p

• 使用 CREATE DATABASE helloworld CHARACTER SET utf8 COLLATE utf8_general_ci; 创建一个新的数据库。

步骤 2 - 在 config/db.php 文件中配置数据库连接。以下配置适用于当前使用的系统。

<?php
   return [
      'class' => 'yii\db\Connection',
      'dsn' => 'mysql:host=localhost;dbname=helloworld',
      'username' => 'vladimir',
      'password' => '12345',
      'charset' => 'utf8',
   ];
?>

步骤 3 - 在根文件夹内运行 ./yii migrate/create test_table。此命令将创建一个数据库迁移文件来管理我们的数据库。迁移文件应该出现在项目根目录的 migrations 文件夹中。

步骤 4 - 修改迁移文件（在本例中为 m160106_163154_test_table.php）。

<?php
   use yii\db\Schema;
   use yii\db\Migration;
   class m160106_163154_test_table extends Migration {
      public function safeUp() {
         $this->createTable("user", [
            "id" => Schema::TYPE_PK,
            "name" => Schema::TYPE_STRING,
            "email" => Schema::TYPE_STRING,
         ]);
         $this->batchInsert("user", ["name", "email"], [
            ["User1", "[email protected]"],
            ["User2", "[email protected]"],
            ["User3", "[email protected]"],
            ["User4", "[email protected]"],
            ["User5", "[email protected]"],
            ["User6", "[email protected]"],
            ["User7", "[email protected]"],
            ["User8", "[email protected]"],
            ["User9", "[email protected]"],
            ["User10", "[email protected]"],
            ["User11", "[email protected]"],
         ]);
      }
      public function safeDown() {
         $this->dropTable('user');
      }
   }
?>

上述迁移创建了一个名为 user 的表，包含 id、name 和 email 字段。它还添加了一些演示用户。

步骤 5 - 在项目根目录内运行 ./yii migrate 将迁移应用到数据库。

步骤 6 - 现在，我们需要为我们的 user 表创建一个模型。为简便起见，我们将使用 Gii 代码生成工具。打开此 url: https://127.0.0.1:8080/index.php?r=gii。然后，点击“Model generator”下的“Start”按钮。填写表名（“user”）和模型类名（“MyUser”），点击“Preview”按钮，最后点击“Generate”按钮。

MyUser 模型应该出现在 models 目录中。

创建事件

假设我们希望每当有新用户注册到我们的网站时，向管理员发送一封电子邮件。

步骤 1 - 修改 models/MyUser.php 文件。

<?php
   namespace app\models;
   use Yii;
   /**
   * This is the model class for table "user".
   *
   * @property integer $id
   * @property string $name
   * @property string $email
   */
   class MyUser extends \yii\db\ActiveRecord {
      const EVENT_NEW_USER = 'new-user';
      public function init() {
         // first parameter is the name of the event and second is the handler.
         $this->on(self::EVENT_NEW_USER, [$this, 'sendMailToAdmin']);
      }
      /**
      * @inheritdoc
      */
      public static function tableName() {
         return 'user';
      }
      /**
      * @inheritdoc
      */
      public function rules() {
         return [
            [['name', 'email'], 'string', 'max' => 255]
         ];
      }
      /**
      * @inheritdoc
      */
      public function attributeLabels() {
         return [
            'id' => 'ID',
            'name' => 'Name',
            'email' => 'Email',
         ];
      }
      public function sendMailToAdmin($event) {
         echo 'mail sent to admin using the event';
      }
   }
?>

在上面的代码中，我们定义了一个“new-user”事件。然后，在 init() 方法中，我们将 sendMailToAdmin 函数附加到“new-user”事件。现在，我们需要触发此事件。

步骤 2 - 在 SiteController 中创建一个名为 actionTestEvent 的方法。

public function actionTestEvent() {
   $model = new MyUser();
   $model->name = "John";
   $model->email = "[email protected]";
   if($model->save()) {
      $model->trigger(MyUser::EVENT_NEW_USER);
   }
}

在上面的代码中，我们创建了一个新用户并触发了“new-user”事件。

步骤 3 - 现在输入 https://127.0.0.1:8080/index.php?r=site/test-event，您将看到以下内容。