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。然后，单击“模型生成器”标题下的“开始”按钮。填写表名（“user”）和模型类（“MyUser”），单击“预览”按钮，最后单击“生成”按钮。

MyUser 模型出现在 models 目录中。

分页实战

步骤 1 - 向 SiteController 添加一个 actionPagination 方法。

public function actionPagination() {
   //preparing the query
   $query = MyUser::find();
   // get the total number of users
   $count = $query->count();
   //creating the pagination object
   $pagination = new Pagination(['totalCount' => $count, 'defaultPageSize' => 10]);
   //limit the query using the pagination and retrieve the users
   $models = $query->offset($pagination->offset)
      ->limit($pagination->limit)
      ->all();
   return $this->render('pagination', [
      'models' => $models,
      'pagination' => $pagination,
   ]);
}

步骤 2 - 在 views/site 文件夹内创建一个名为 pagination.php 的视图文件。

<?php
   use yii\widgets\LinkPager;
?>
<?php foreach ($models as $model): ?>
   <?= $model->id; ?>
   <?= $model->name; ?>
   <?= $model->email; ?>
   <br/>
<?php endforeach; ?>
<?php
   // display pagination
   echo LinkPager::widget([
      'pagination' => $pagination,
   ]);
?>

现在，通过 Web 浏览器访问本地主机 https://127.0.0.1:8080/index.php?r=site/pagination，您将看到一个分页小部件 -