分页本质是通过当前页码和每页条数计算偏移量（$offset = ($page - 1) * $pageSize）来实现数据截取；文中提供了一个纯PHP可复用分页函数，返回包含总页数、页码范围、上下页状态等完整信息的数组，并强调需过滤输入、缓存总数、处理空结果及规范URL参数拼接。
分页的核心其实是算两个数
分页不是什么黑科技，本质就靠两个关键数字：当前页码（$page）和每页条数（$pageSize）。有了它们，就能算出从数据库第几条开始取数据——也就是偏移量：$offset = ($page - 1) * $pageSize。比如第3页、每页10条，那就跳过前20条，从第21条查起（MySQL里用 LIMIT $offset, $pageSize）。
手写一个可复用的分页函数
下面这个函数不依赖任何框架，纯PHP，传入总记录数、当前页、每页条数，自动返回包含页码范围、上一页/下一页、是否首页末页等信息的数组：
function getPagination($total, $page = 1, $pageSize = 10, $maxShow = 5) {
$page = max(1, (int)$page);
$pageSize = max(1, (int)$pageSize);
$total = max(0, (int)$total);
$pages = ceil($total / $pageSize); // 总页数
$page = min($page, $pages ?: 1);
$start = max(1, $page - floor($maxShow / 2));
$end = min($pages, $start + $maxShow - 1);
$start = max(1, $end - $maxShow + 1);
return [
'total' => $total,
'pages' => $pages,
'page' => $page,
'pageSize' => $pageSize,
'offset' => ($page - 1) * $pageSize,
'hasPrev' => $page > 1,
'hasNext' => $page < $pages,
'isFirst' => $page == 1,
'isLast' => $page == $pages,
'range' => range($start, $end),
];}
调用示例：
$total = $pdo->query("SELECT COUNT(*) FROM articles")->fetchColumn();
$pagination = getPagination($total, $_GET['page'] ?? 1, 12);
// 查询数据
$stmt = $pdo->prepare("SELECT * FROM articles ORDER BY id DESC LIMIT ?, ?");
$stmt->execute([$pagination['offset'], $pagination['pageSize']]);
$articles = $stmt->fetchAll();
前端分页HTML可以很简单
不用JS也能做出清爽的页码栏。注意几点：
- 当前页加 class="active" 样式突出
- 首页、末页、上一页、下一页按钮要判断是否禁用（比如第1页时“上一页”应灰掉或不链接）
- 页码太多时只显示局部（上面函数里的 $maxShow 就是干这个的）
- URL参数保留其他查询条件，例如 ?category=php&page=3
简单模板片段（PHP输出）：
" >首页 " >上一页" >
" >下一页 " >末页
几个容易踩的坑
实际写的时候常被忽略，但一出错就整页崩：
- $_GET['page'] 没过滤：必须转成整型并限制最小值，否则可能传入负数或SQL注入风险
-
总记录数没缓存：COUNT(*) 在大数据表上很慢，可考虑用近似值或加缓存（如Redis存10分钟
） - 没处理空结果：当 $pages == 0 时，$pagination['range'] 会报错，函数里已用 $pages ?: 1 防御
- URL参数拼接混乱：建议统一提取除 page 外的其他参数，生成 $queryStr = http_build_query($params)
）基本上就这些。逻辑清晰、边界守好，分页就稳了。
