7.5 项目实现迭代十：分页显示列表页-Yii2框架从入门到精通(中)

当前位置:　首页>> 技术小册>> Yii2框架从入门到精通(中)

### 7.5 项目实现迭代十：分页显示列表页

在Web开发中，随着数据量的不断增长，如何高效地展示这些信息给用户成为了一个重要的议题。分页显示是一种常见且有效的解决方案，它允许用户按批次查看数据，既提升了用户体验，也减轻了服务器的负担。在Yii2框架中，实现分页功能既简单又强大，本章节将详细介绍如何在Yii2项目中实现列表页的分页显示。

#### 7.5.1 理解分页原理

分页的基本原理是将数据集合分割成多个子集，每次只加载并显示一个子集给用户。在Yii2中，这一过程通常通过`yii\data\Pagination`类和`yii\widgets\LinkPager`（或`yii\widgets\ListView`、`yii\grid\GridView`等）来实现。`Pagination`类负责处理分页逻辑，如计算总页数、当前页码等；而`LinkPager`等小部件则负责生成分页链接供用户点击。

#### 7.5.2 准备数据模型

在实现分页之前，确保你有一个合适的数据模型（Model）和数据库表。假设我们有一个`Post`模型，对应数据库中的`post`表，该表存储了文章信息。

```php
// Post模型示例
namespace app\models;

use yii\db\ActiveRecord;

class Post extends ActiveRecord
{
    // 覆盖表名
    public static function tableName()
    {
        return '{{%post}}';
    }

// 其他模型方法...
}
```

#### 7.5.3 使用Pagination类

在控制器中，使用`Pagination`类来设置分页参数，并查询出当前页的数据。

```php
// 控制器中的action方法示例
namespace app\controllers;

use Yii;
use yii\web\Controller;
use app\models\Post;
use yii\data\Pagination;

class PostController extends Controller
{
    public function actionIndex()
    {
        $query = Post::find();

// 获取总记录数
        $count = $query->count();

// 创建分页对象
        $pagination = new Pagination(['totalCount' => $count]);

// 设置每页显示的数量
        $pagination->defaultPageSize = 10;

// 使用分页对象修改查询，以获取当前页的数据
        $posts = $query->offset($pagination->offset)
            ->limit($pagination->limit)
            ->all();

// 将数据和分页对象传递给视图
        return $this->render('index', [
            'posts' => $posts,
            'pagination' => $pagination,
        ]);
    }
}
```

#### 7.5.4 在视图中显示分页链接

在视图文件中，使用`LinkPager`小部件来显示分页链接。

```php

<?php
use yii\widgets\LinkPager;
?>

<h1>文章列表</h1>
<ul>
    <?php foreach ($posts as $post): ?>
        <li><?= Html::encode($post->title) ?></li>
    <?php endforeach; ?>
</ul>

<?= LinkPager::widget([
    'pagination' => $pagination,
]); ?>
```

`LinkPager`小部件会自动根据`$pagination`对象生成分页链接。你可以通过配置`LinkPager`的属性来自定义分页链接的样式，比如`options`用于设置整个分页导航的HTML属性，`linkOptions`用于设置每个分页链接的HTML属性等。

#### 7.5.5 自定义分页样式

Yii2允许你通过CSS和JavaScript来自定义分页链接的样式和行为。你可以直接在视图中通过`<style>`标签或外部CSS文件来定义样式，也可以通过JavaScript来增强分页的交互性。

例如，你可以使用Bootstrap的CSS类来美化分页链接：

```php
<?= LinkPager::widget([
    'pagination' => $pagination,
    'options' => ['class' => 'pagination pagination-sm'],
    'linkOptions' => ['class' => 'page-link'],
]); ?>
```

然后，确保你的项目中已经包含了Bootstrap的CSS文件。

#### 7.5.6 性能优化

虽然分页本身已经帮助提高了性能，但在处理大量数据时，仍有一些额外的优化措施可以采取：

- **索引优化**：确保你的数据库表上有适当的索引，特别是用于查询条件的字段。
- **缓存**：利用Yii2的缓存机制，缓存查询结果或分页对象，减少数据库查询次数。
- **懒加载**：对于关联数据，考虑使用懒加载而非饥渴加载，以减少不必要的查询。

#### 7.5.7 注意事项

- 分页时，确保你的查询条件是固定的，否则可能会导致数据在不同页之间“跳跃”。
- 考虑到SEO和用户体验，合理设置每页显示的条目数。
- 分页参数（如当前页码）通常通过GET请求传递，确保你的应用能够正确处理这些参数。

#### 结语

通过本章节的学习，你应该已经掌握了在Yii2框架中实现列表页分页显示的基本方法。分页功能是Web开发中不可或缺的一部分，它不仅能够提升用户体验，还能有效管理数据展示。希望你在实践中能够灵活运用这些知识，不断优化你的Web应用。