在PHP项目开发中，当数据库表存储的数据量达到上千甚至上万条时，直接查询全部数据展示到页面会造成严重的性能问题，分页功能可以将数据按固定条数拆分到不同页面，是处理大量数据展示的常用方案。本文汇总了多种PHP实现分页的方法，覆盖原生开发和主流框架场景，帮助开发者快速落地分页需求。
分页功能的核心逻辑
无论使用哪种方式实现分页，核心逻辑都围绕两个参数展开：当前页码和每页显示条数。通过这两个参数可以计算出数据库查询时的偏移量，再结合MySQL的limit语句获取对应页的数据。核心计算公式如下：
- 偏移量 = (当前页码 - 1) * 每页显示条数
- 总页数 = 向上取整(总数据条数 / 每页显示条数)
原生PHP+MySQL实现分页
这是最基础的分页实现方式，不依赖任何框架，适合原生PHP项目使用。实现步骤分为三步：获取分页参数、查询总数据条数、查询当前页数据。
1. 获取分页参数
通常当前页码通过GET请求传递，需要做合法性校验，避免出现负数或者非数字的情况。
<?php
// 获取当前页码，默认第一页
$page = isset($_GET['page']) ? intval($_GET['page']) : 1;
// 每页显示10条数据
$pageSize = 10;
// 页码合法性校验
if ($page < 1) {
$page = 1;
}
?>
2. 查询总数据条数和总页数
先查询数据表的总记录数，再根据每页条数计算总页数。
<?php
// 假设已经建立好数据库连接 $conn
// 查询总数据条数
$countSql = "SELECT COUNT(*) as total FROM article";
$countResult = mysqli_query($conn, $countSql);
$countRow = mysqli_fetch_assoc($countResult);
$total = $countRow['total'];
// 计算总页数
$totalPage = ceil($total / $pageSize);
// 页码超出总页数时调整到最后一页
if ($page > $totalPage && $totalPage > 0) {
$page = $totalPage;
}
// 计算偏移量
$offset = ($page - 1) * $pageSize;
?>
3. 查询当前页数据并展示
使用limit语句结合偏移量和每页条数查询当前页的数据，然后渲染到页面中。
<?php
// 查询当前页数据
$dataSql = "SELECT id, title, create_time FROM article LIMIT $offset, $pageSize";
$dataResult = mysqli_query($conn, $dataSql);
$list = [];
while ($row = mysqli_fetch_assoc($dataResult)) {
$list[] = $row;
}
?>
<!-- 数据展示区域 -->
<table border="1" cellpadding="10" cellspacing="0">
<tr>
<th>文章ID</th>
<th>文章标题</th>
<th>创建时间</th>
</tr>
<?php foreach ($list as $item): ?>
<tr>
<td><?php echo $item['id']; ?></td>
<td><?php echo $item['title']; ?></td>
<td><?php echo $item['create_time']; ?></td>
</tr>
<?php endforeach; ?>
</table>
4. 生成分页导航
分页导航需要展示首页、上一页、下一页、尾页，以及页码跳转功能。
<div class="page-nav">
<a href="?page=1">首页</a>
<a href="?page=<?php echo $page > 1 ? $page - 1 : 1; ?>">上一页</a>
<?php for ($i = 1; $i <= $totalPage; $i++): ?>
<?php if ($i == $page): ?>
<strong><?php echo $i; ?></strong>
<?php else: ?>
<a href="?page=<?php echo $i; ?>"><?php echo $i; ?></a>
<?php endif; ?>
<?php endfor; ?>
<a href="?page=<?php echo $page < $totalPage ? $page + 1 : $totalPage; ?>">下一页</a>
<a href="?page=<?php echo $totalPage; ?>">尾页</a>
</div>
ThinkPHP框架分页实现
主流PHP框架都内置了分页组件，以ThinkPHP6为例，只需要简单调用内置方法就可以实现分页，不需要手动计算偏移量和总页数。
<?php
namespace appcontroller;
use thinkfacadeDb;
use thinkfacadeView;
class Article
{
public function index()
{
// 查询文章数据，每页显示15条，使用内置分页
$list = Db::name('article')->paginate(15);
// 渲染模板，将分页数据传递到页面
return View::fetch('index', ['list' => $list]);
}
}
?>
在对应的模板文件中，可以直接渲染分页导航：
<!-- 数据列表展示 -->
<ul>
<?php foreach ($list as $item): ?>
<li><?php echo $item['title']; ?> - <?php echo $item['create_time']; ?></li>
<?php endforeach; ?>
</ul>
<!-- 渲染分页导航，内置样式可自定义 -->
<div class="page">
<?php echo $list->render(); ?>
</div>
分页实现注意事项
- 需要对传入的页码参数做严格校验，避免SQL注入和非法页码导致的查询错误
- 当数据量特别大时，limit offset, pageSize的查询效率会随着offset增大而降低，可以考虑使用基于ID的游标分页优化
- 分页导航的样式可以根据项目需求自定义，核心是保证用户能清晰知道当前所在页码和总页数
- 如果数据实时性要求高，每次查询总条数时建议不要使用缓存，避免数据更新后分页显示异常
分页功能的核心是通过合理的参数计算拆分数据查询范围，开发者可以根据项目使用的技术栈选择对应的实现方式，原生实现适合理解原理，框架内置组件适合快速开发。