PHP分页添加上一页下一页功能操作教程
时间：2026-06-16 | 作者：318050 | 阅读：0翻页功能看似简单，但真正实现“上一页/下一页”不出错的项目，十个里有三个会栽在细节上。
下面这几个坑，当年调试到凌晨才摸清门道。列出来给后来人省点时间。
分页链接里 page 参数没传对，下一页就 404
核心问题：page 参数必须正确读取、校验、拼进链接
PHP 分页不是写个循环就能“上下翻”的。核心是 URL 里的 page 参数，必须被正确读取、校验、拼进下一页链接。
常见错误：直接写死 https://example.com/page.phppage=1， 或者用 $_GET['page'] + 1 却不判断是否越界。结果点“下一页”跳到不存在的页码，返回空数据或 404。
实操建议
- 参数过滤：
$_GET['page']一定要用filter_input(INPUT_GET, 'page', FILTER_SANITIZE_NUMBER_INT)或强转(int)，避免注入或非法值。 - 页码范围：当前页码不能小于 1。最大页码由总记录数和每页条数算出：
$total_pages = ceil($total_count / $per_page)。 - 链接渲染条件：“下一页”链接只在
$current_page < $total_pages时渲染。href 拼的是page=，不是固定值。 - 保留其他参数：保留其他查询参数（比如搜索关键词
q=abc），否则点下一页会丢条件。用http_build_query(array_merge($_GET, ['page' => $next]))。
用 mysqli 做 LIMIT 分页时 OFFSET 越大越慢
性能瓶颈：OFFSET 大导致 MySQL 扫描大量无用记录
当用户翻到第 1000 页，LIMIT 9990, 10 这种写法会让 MySQL 扫描近一万个记录再丢弃，响应明显变卡。
这不是 PHP 的锅，但 PHP 层如果没意识到底层代价，就会把性能问题甩给数据库。
实操建议
- 改用游标分页：优先改用「游标分页」（cursor-based）。用上一页最后一条的
id或时间戳做条件，例如WHERE id > 12345 ORDER BY id LIMIT 10，跳过 OFFSET。 - 优化索引：如果必须用
LIMIT+OFFSET，加联合索引覆盖ORDER BY和WHERE字段，比如INDEX(status, created_at)。 - 限制最大页码：在 PHP 中限制最大可访问页码，比如
min($page, 200)，防止用户手动输超大页数拖垮数据库。
$_GET['page'] 是字符串，直接比较会出错
字符串比较陷阱：字典序导致页码判断异常
PHP 里 '10' > '2' 是 false，因为字符串比较按字典序。如果你没转类型就写 if ($_GET['page'] > 1)，第 10 页可能被当成比第 2 页小，导致“上一页”按钮异常消失。
实操建议
- 显式转整型：所有页码参与逻辑判断前，必须显式转整型：
$page = (int) $_GET['page'];。 - 不要依赖隐式转换：
if ($page > 1)安全，if ($_GET['page'] > 1)不安全。 - 注意边界值：
(int) ''得 0，(int) 'abc'也得 0，所以先过滤再转。或用filter_var($_GET['page'], FILTER_VALIDATE_INT)判断有效性。
Bootstrap 分页样式和 PHP 逻辑混在一起，改起来费劲
代码耦合：HTML、CSS、PHP 混写导致维护困难
把 HTML 标签、CSS 类、PHP 变量全塞在一个 echo 里，比如 echo '。
后期想换 Tailwind 或加 aria-label 就得逐行改，还容易漏引号、拼错变量。
实操建议
- 结构分离：分页 HTML 结构单独抽成数组或函数返回，比如
get_pagination_html($current, $total)，里面只管结构和逻辑。 - 链接生成统一：链接生成统一走一个函数：
build_page_url(['page' => $p])，内部处理参数合并和 URL 编码。 - 样式类名配置化：样式类名别硬编码，用配置项控制，比如
$pager_class = 'pagination-sm';，换框架时只改这一处。
事情说清了就结束。最常被忽略的是：页码参数没过滤就进 SQL，以及 OFFSET 分页没设上限。 这两点线上出问题，往往不是报错，而是慢得让人以为服务挂了。