PHP分页需正确处理page参数、避免OFFSET性能陷阱及类型安全问题:须过滤校验page值、限制最大页码、改用游标分页或优化索引,并分离HTML结构与逻辑。

分页链接里 page 参数没传对,下一页就 404
PHP 分页不是写个循环就能“上下翻”的,核心是 URL 里的 page 参数必须被正确读取、校验、拼进下一页链接。常见错误是直接写死 https://www.php.cn/link/00cada81b307d5db4a1920b952e2137e2,或者用 $_GET['page'] + 1 却不判断是否越界——结果点“下一页”跳到不存在的页码,返回空数据或 404。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
-
$_GET['page']一定要用filter_input(INPUT_GET, 'page', FILTER_SANITIZE_NUMBER_INT)或强转(int),避免注入或非法值 - 当前页码不能小于 1,最大页码由总记录数和每页条数算出:
$total_pages = ceil($total_count / $per_page) - “下一页”链接只在
$current_page 时渲染,且 href 拼的是https://www.php.cn/link/00cada81b307d5db4a1920b952e2137e,不是固定值 - 保留其他查询参数(比如搜索关键词
q=abc),否则点下一页会丢条件:用http_build_query(array_merge($_GET, ['page' => $next]))
用 mysqli 做 LIMIT 分页时 OFFSET 越大越慢
当用户翻到第 1000 页,LIMIT 9990, 10 这种写法会让 MySQL 扫描近一万个记录再丢弃,响应明显变卡。这不是 PHP 的锅,但 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 页小,导致“上一页”按钮异常消失。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 所有页码参与逻辑判断前,必须显式转整型:
$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 变量全塞在一个 echo 里,比如 echo ',后期想换 Tailwind 或加 aria-label 就得逐行改,还容易漏引号、拼错变量。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 分页 HTML 结构单独抽成数组或函数返回,比如
get_pagination_html($current, $total),里面只管结构和逻辑 - 链接生成统一走一个函数:
build_page_url(['page' => $p]),内部处理参数合并和 URL 编码 - 样式类名别硬编码,用配置项控制,比如
$pager_class = 'pagination-sm';,换框架时只改这一处










