总页数 = ceil(总记录数 / 每页条数)；须校验总记录数≥0且每页条数>0，非法时返回0；避免用floor+1或intval+1，防止边界错误；注意缓存/估算总数需明确注释。
总页数公式就是 ceil($total / $per_page)
别绕弯子：总页数 = 向上取整（总记录数 ÷ 每页条数）。PHP 里直接用 ceil()，不是 round()，也不是 intval() + 1。因为 ceil(9.1) 是 10，ceil(10) 还是 10；而 round(9.1) 是 9，intval(9.9)+1 看似可行但边界易错（比如总数为 0 时会得 1）。
常见错误现象：
- 用
floor($total / $per_page) + 1—— 当$total为 0 时结果是 1（错！应为 0） - 忽略整除情况，硬加 1 导致多出一页
- 传入非数字（如空字符串、null）进
ceil()，触发警告或返回 0
必须校验 $total 和 $per_page 的合法性
真实业务中，这两个值往往来自数据库查询或用户输入，不校验就直接算，分分钟翻车。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
$total应为非负整数：is_int($total) && $total >= 0，若从 DB 取出是字符串，先(int)$total强转再判断 -
$per_page必须大于 0，且建议设上限（如 ≤ 100），防恶意请求拖垮 MySQL LIMIT 偏移量 - 任一参数非法，应直接返回 0 页或抛异常，而不是让
ceil()处理 NaN 或负数
示例片段：
$total = (int)$pdo->query("SELECT COUNT(*) FROM posts WHERE status=1")->fetchColumn();
$per_page = max(1, min(100, (int)($_GET['limit'] ?? 20)));
if ($total < 0 || $per_page <= 0) {
$total_pages = 0;
} else {
$total_pages = (int)ceil($total / $per_page);
}
注意分页偏移量（OFFSET）和总页数的联动关系
总页数只是个数字，真正影响渲染的是当前页码 $page 是否合法——它必须满足 1 ，否则要么 404，要么自动归正。
容易踩的坑：
- 用
$page = (int)$_GET['page'] ?: 1，但没检查是否超过$total_pages，导致最后一页查不到数据却仍显示空白列表 - MySQL 的
LIMIT $offset, $per_page中，$offset = ($page - 1) * $per_page，当$page > $total_pages时，$offset可能极大，浪费查询资源 - 总数为 0 时，
$total_pages === 0，此时$page无论多少都该跳过分页逻辑
大数据量下，COUNT(*) 不等于总页数的可靠来源
当表有几百万行，COUNT(*) 变成性能瓶颈，甚至被慢查询日志反复报警。这时“总页数”本身已失去精确意义，应改用估算或游标分页。
可选方案：
- 缓存 COUNT 结果（如 Redis），设置较短 TTL（例如 5 分钟），接受轻微不一致
- 用
EXPLAIN SELECT ...提取rows估算值（不精准，但快） - 彻底放弃总页数显示，改用“下一页”按钮 + 光标（如
WHERE id > ? ORDER BY id LIMIT 20）
这时候，ceil($total / $per_page) 的 $total 已不是真实 COUNT，而是缓存值或估算值——这点必须在代码注释里写清楚，否则接手的人会以为还能信。
