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", "user1@gmail.com"],
            ["User2", "user2@gmail.com"],
            ["User3", "user3@gmail.com"],
            ["User4", "user4@gmail.com"],
            ["User5", "user5@gmail.com"],
            ["User6", "user6@gmail.com"],
            ["User7", "user7@gmail.com"],
            ["User8", "user8@gmail.com"],
            ["User9", "user9@gmail.com"],
            ["User10", "user10@gmail.com"],
            ["User11", "user11@gmail.com"],
         ]);
      }
      public function safeDown() {
         $this->dropTable('user');
      }
   }
?>

上述遷移建立了一個具有以下欄位的 user 表：id、name 和 email。它還添加了一些演示使用者。

步驟 5 − 在專案根目錄內 執行 ./yii migrate 將遷移應用到資料庫。

步驟 6 − 現在，我們需要為我們的 user 表建立一個模型。為簡單起見，我們將使用 Gii 程式碼生成工具。開啟此 url: https://: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://:8080/index.php?r=site/data-widget，您將看到 DetailView 部件的典型用法。