Yii - 排序

在顯示大量資料時，我們經常需要對資料進行排序。Yii 使用一個yii\data\Sort 物件來表示排序方案。

要展示排序的實際操作，我們需要資料。

準備資料庫

步驟 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 目錄中。

排序實戰

步驟 1 - 向SiteController新增一個actionSorting方法。

public function actionSorting() {
   //declaring the sort object
   $sort = new Sort([
      'attributes' => ['id', 'name', 'email'], 
   ]);
   //retrieving all users
   $models = MyUser::find()
      ->orderBy($sort->orders)
      ->all();
   return $this->render('sorting', [
      'models' => $models,
      'sort' => $sort,
   ]);
}

步驟 2 - 在 views/site 資料夾內建立一個名為sorting的檢視檔案。

<?php
   // display links leading to sort actions
   echo $sort->link('id') . ' | ' . $sort->link('name') . ' | ' . $sort->link('email');
?><br/>
<?php foreach ($models as $model): ?>
   <?= $model->id; ?>
   <?= $model->name; ?>
   <?= $model->email; ?>
   <br/>
<?php endforeach; ?>

步驟 3 - 現在，如果您在 Web 瀏覽器中輸入https://:8080/index.php?r=site/sorting，您會看到 id、name 和 email 欄位是可排序的，如下面的圖片所示。