Yii - 数据部件

Yii 提供了一套用于显示数据的部件。您可以使用 DetailView 部件显示单条记录。ListView 部件以及 GridView 部件可用于显示具有过滤、排序和分页等功能的记录表。

准备数据库

步骤 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 目录中。

DetailView 部件

DetailView 部件显示单个模型的数据。$attributes 属性定义了要显示哪些模型属性。

步骤 1 − 将 actionDataWidget 方法添加到 SiteController。

public function actionDataWidget() {
   $model = MyUser::find()->one();
   return $this->render('datawidget', [
      'model' => $model
   ]);
}

在上面的代码中，我们找到第一个 MyUser 模型并将其传递到 datawidget 视图。

步骤 2 − 在 views/site 文件夹内创建一个名为 datawidget.php 的文件。

<?php
   use yii\widgets\DetailView;
   echo DetailView::widget([
      'model' => $model,
      'attributes' => [
         'id',
         //formatted as html
         'name:html',
         [
            'label' => 'e-mail',
            'value' => $model->email,
         ],
      ],
   ]);
?>

步骤 3 − 如果您访问 https://127.0.0.1:8080/index.php?r=site/data-widget，您将看到 DetailView 部件的典型用法。