在ThinkPHP框架中，分页功能的实现不需要开发者手动处理偏移量、总条数等复杂逻辑，框架内置的paginate方法已经封装了完整的分页流程，只需要结合查询构造器即可快速完成分页开发。
基础分页实现步骤
首先需要在控制器中引入对应的模型或者通过Db类进行数据库查询，调用paginate方法传入每页显示的条数即可获取分页对象，示例代码如下：
<?php
namespace app\controller;
use think\facade\Db;
use think\Request;
class Article
{
// 文章列表分页
public function index(Request $request)
{
// 获取当前页码，默认第一页
$page = $request->param('page', 1);
// 每页显示10条数据
$pageSize = 10;
// 查询文章列表并分页
$articleList = Db::name('article')
->where('status', 1)
->order('create_time', 'desc')
->paginate([
'list_rows' => $pageSize,
'page' => $page,
]);
// 获取分页渲染的HTML
$pageHtml = $articleList->render();
// 获取分页的总条数
$total = $articleList->total();
return view('index', [
'list' => $articleList->items(),
'pageHtml' => $pageHtml,
'total' => $total
]);
}
}分页参数配置说明
paginate方法支持传入多个配置参数，可根据实际需求调整分页行为，常用的配置参数如下：
- list_rows：每页显示的记录数，默认值为15
- page：当前页码，不传入时会自动从请求参数中获取page值
- var_page：分页页码的请求变量名，默认是page
- query：分页跳转时需要携带的额外参数，比如搜索条件
如果需要携带搜索条件进行分页，可以这样配置参数：
<?php
// 假设有搜索关键词参数keyword
$keyword = $request->param('keyword', '');
$articleList = Db::name('article')
->when($keyword, function($query) use ($keyword) {
$query->whereLike('title', '%'.$keyword.'%');
})
->paginate([
'list_rows' => 10,
'query' => ['keyword' => $keyword] // 分页携带搜索参数
]);自定义分页样式
默认的分页渲染样式可能不符合项目需求，可以通过修改分页配置文件或者自定义分页驱动来调整样式。分页配置文件位于config/pagination.php，可以修改默认的分页类名、模板路径等配置。
如果是简单的样式调整，也可以直接在模板中对render方法返回的分页HTML进行修改，或者使用框架提供的分页模板标签自定义分页结构，示例如下：
<div class="page-wrap">
<!-- 上一页 -->
<?php if($pageHtml->currentPage() > 1): ?>
<a href="?page=<?php echo $pageHtml->currentPage() - 1; ?>" class="page-btn">上一页</a>
<?php endif; ?>
<!-- 页码列表 -->
<?php for($i=1; $i<=$pageHtml->lastPage(); $i++): ?>
<a href="?page=<?php echo $i; ?>" class="<?php echo $i == $pageHtml->currentPage() ? 'active' : ''; ?>">
<?php echo $i; ?>
</a>
<?php endfor; ?>
<!-- 下一页 -->
<?php if($pageHtml->currentPage() < $pageHtml->lastPage()): ?>
<a href="?page=<?php echo $pageHtml->currentPage() + 1; ?>" class="page-btn">下一页</a>
<?php endif; ?>
</div>分页性能优化技巧
在实际开发中，分页功能如果处理不当容易出现性能问题，以下是几个常用的优化方法：
- 查询时只选择需要的字段，避免使用
select *，减少数据传输和数据库查询开销 - 合理设置每页显示条数，不要设置过大的分页大小，避免单次查询返回过多数据
- 如果数据量非常大，可以考虑使用延迟关联优化分页查询，先查询主键再关联获取详细数据
- 对于不常变化的数据分页结果，可以添加缓存，减少数据库查询次数
延迟关联优化的示例代码如下，适合百万级以上数据量的表分页场景：
<?php
// 先查询分页对应的主键ID
$subQuery = Db::name('article')
->where('status', 1)
->order('create_time', 'desc')
->paginate(10)
->items()
->column('id');
// 再根据主键ID查询完整的文章数据
$articleList = Db::name('article')
->whereIn('id', $subQuery)
->select();按照以上的方法，就可以在ThinkPHP中快速实现稳定高效的分页功能，满足不同项目的分页需求。