Pagination构造函数必须接收当前页、总条数、每页条数三个参数，缺一不可；SQL偏移量为($currentPage-1)*$perPage；分页HTML需动态计算页码范围并保留查询参数。
PHP分页类怎么设计构造函数参数
面向对象分页的核心不是“写个类”，而是让 Pagination 知道当前页、总条数、每页几条——少了任一，结果必错。构造函数必须接收这三个关键值，缺一不可。
常见错误是把 $currentPage 写成可选参数并默认为 1，但实际中 URL 传参可能为空、为非数字、为负数，直接用会导致越界或查出空页。
-
$totalItems必须是整数，且不能为 0（否则$totalPages = 0，后续除零或逻辑崩） -
$perPage建议设默认值（如 10），但必须校验 > 0，否则分页失效甚至报 Warning -
$currentPage应从$_GET['page']取，但必须强制过滤：max(1, (int)($_GET['page'] ?? 1))
如何生成正确的分页 SQL LIMIT 子句
MySQL 的 LIMIT 是偏移量 + 数量，而面向对象分页类里最容易错的，就是把页码直接当偏移量用——第 1 页偏移是 0，第 2 页是 $perPage，不是 2。
正确公式是：($currentPage - 1) * $perPage。漏减 1，首页就跳过前 N 条；溢出计算，末页可能查不到数据还报错。
立即学习“PHP免费学习笔记（深入）”；
- 不要在类里拼完整 SQL，只返回
[$offset, $limit]数组更安全、更易测 - 如果用 PDO，直接把这两个值 bind 到
prepare()即可，避免字符串拼接注入 - 注意：SQLite 和 PostgreSQL 的 LIMIT 语法一致，但某些旧版 MySQL 不支持大偏移量，超 10 万行建议改用游标分页
渲染分页 HTML 时为什么总少“当前页”高亮
不是没写 active 类，而是判断逻辑写成了 $i == $currentPage，但循环变量 $i 没对齐真实页码范围——比如总页数是 5，但循环从 1 到 10，中间一堆无效页码。
标准做法是先算出显示范围：$start = max(1, $currentPage - 2)，$end = min($totalPages, $currentPage + 2)，再在这个区间内遍历。
- 前后省略号不是靠 CSS 隐藏，而是靠条件判断：若
$start > 1才渲染「1」和「...」 - 上一页链接的
page参数必须是max(1, $currentPage - 1)，否则点到第 1 页再点“上一页”会变成 page=0 - 所有链接 href 中的
page值必须是整数，不要带空格或字母，否则路由解析失败
为什么换页后排序或搜索条件丢了
分页链接没保留原始查询参数，比如 ?search=php&sort=name，翻页时只写了 ?page=2，导致搜索清空——这不是分页类的问题，是调用它的人没传上下文。
解决办法只有一个：让分页类接受一个 $queryParams 数组（如 $_GET 除去 page 后的其余键值），然后在生成链接时自动拼上。
- 别在类里读
$_GET，那会让类无法单元测试，也耦合了请求生命周期 - URL 编码要交给
http_build_query()，别手动urlencode()每个值，容易漏或重复编码 - 如果用了重写规则（如 nginx 的
try_files），确保分页链接路径与当前 URL 基础路径一致，否则跳转 404
最常被忽略的，是分页类根本没处理数据库查询总数这一步——它不负责查 COUNT(*)，只负责算页码和 LIMIT。谁来查总数、怎么缓存这个总数、总数是否含 WHERE 条件，全得外面想清楚。类只是数学工具，不是魔法盒子。
