分页是 Web 开发中最常见的功能之一，也是面试中高频出现的话题。很多候选人对 ThinkPHP 分页的使用了如指掌，但当面试官追问“Paginator 底层是怎么实现的”“如何自定义一个分页器”时，往往答不上来。本文将从源码角度剖析 ThinkPHP 分页器 Paginator 的核心原理，并手把手带你实现自定义分页。
一、为什么面试官爱问分页器
分页看似简单，实则考察多个维度的能力：
- 框架源码阅读能力：是否理解 Paginator 的构造过程和渲染机制
- 数据库查询优化意识：是否知道 count 查询的开销以及如何避免
- 面向对象设计能力：能否通过继承或接口实现自定义扩展
- 实际场景经验：大数据量下分页的性能问题如何处理
因此，掌握 Paginator 的原理，不仅是应付面试，更是提升工程能力的必经之路。
二、Paginator 的核心原理
2.1 基本使用回顾
在 ThinkPHP 中，分页通常这样使用：
$list = Db::name('user')->paginate(10);
// 在模板中输出分页
echo $list->render();
paginate() 方法返回的是一个 think\Paginator 实例（具体是 Bootstrap 或 Layui 等驱动类的实例），它同时实现了 IteratorAggregate 和 ArrayAccess 接口，因此既可以遍历，也可以像数组一样访问。
2.2 构造过程解析
Paginator 的构造方法接收四个核心参数：
public function __construct($items, $listRows, $currentPage, $total, $simple = false, $options = [])
$items：当前页的数据集合$listRows：每页条数$currentPage：当前页码$total：总记录数$simple：是否使用简洁模式$options：额外配置（如查询参数、路径等）
在 paginate() 方法内部，框架会做三件事：
- 计算总数：执行一条
count(*)查询获取总记录数（除非传入 total） - 计算偏移量：根据当前页和每页条数计算
offset，执行limit查询 - 实例化 Paginator：将数据、总数、页码等传入构造函数
2.3 render() 的渲染机制
render() 方法负责生成分页 HTML。它内部调用 getLinks() 或 getSimpleLinks()，根据当前页、总页数、URL 参数等生成一系列页码链接。核心逻辑包括：
- 计算总页数：
ceil($total / $listRows) - 确定页码区间：默认显示当前页前后各几页（由
var_page和rollPage控制） - 拼接 URL：保留原有查询参数，替换 page 参数
值得注意的是，Paginator 使用了驱动模式，不同的前端框架（Bootstrap、Layui、AmazeUI）对应不同的驱动类，通过 $options['type'] 指定。
三、面试高频追问点
3.1 count 查询能否避免？
这是经典优化问题。当数据量很大时，count(*) 可能很慢。解决方案：
- 使用
paginate($listRows, $simple = true)简洁模式，不显示总页数，从而避免 count 查询 - 手动传入 total，例如从缓存中读取
- 使用“下一页”模式，只判断是否有下一页
3.2 分页参数如何传递？
Paginator 默认从请求中获取 page 参数（可通过 var_page 配置修改）。在生成链接时，会保留当前请求的其他查询参数，这一点在源码中通过 $this->options['query'] 实现。
3.3 大数据量下的深分页问题
limit 1000000, 10 这样的深分页会导致 MySQL 扫描大量无用行。优化手段包括：
- 使用游标分页（基于自增 ID 或时间戳）
- 子查询优化：
where id > (select id from table limit 1000000,1) limit 10 - 业务上限制最大页数
面试中能答出这些，说明你不仅会用框架，更懂底层原理。
四、自定义分页器实战
4.1 继承 Paginator 驱动
ThinkPHP 允许你自定义分页驱动。首先创建一个驱动类：
namespace app\common\paginator;
use think\Paginator;
class Custom extends Paginator
{
protected function getLinks()
{
// 自定义分页 HTML 生成逻辑
$html = '<ul class="my-pagination">';
// ... 根据 $this->currentPage、$this->lastPage 等生成
$html .= '</ul>';
return $html;
}
}
4.2 注册并使用
在配置文件中指定分页驱动：
// config/paginate.php
return [
'type' => 'app\common\paginator\Custom',
];
或者在查询时动态指定：
$list = Db::name('user')->paginate(10, false, ['type' => 'app\common\paginator\Custom']);
4.3 完全自定义分页类
如果不想依赖框架的 Paginator，也可以自己实现一个分页类，核心是接收数据、总数、页码，然后输出 HTML。关键点在于：
- 实现
IteratorAggregate接口以支持 foreach - 实现
ArrayAccess接口以支持数组访问 - 提供
render()方法输出分页条
这样的自定义类可以更灵活地适配项目的前端组件库。
五、总结
ThinkPHP 的 Paginator 是一个设计精巧的组件，它通过驱动模式实现了分页样式的可扩展性，通过接口实现让分页结果既能遍历又能当数组用。面试中，如果你能从构造参数、count 查询优化、深分页问题、自定义驱动四个角度展开，基本能覆盖面试官的所有追问。
建议读者课后阅读 think\Paginator 和 think\paginator\driver\Bootstrap 的源码，亲手写一个自定义驱动，体会其中的设计思想。这不仅是面试的加分项，更是提升 PHP 工程能力的重要一步。
未经允许不得转载：任鹏个人博客 » ThinkPHP 面试精讲：分页器 Paginator 原理与自定义分页
