分页本质是通过当前页码和每页条数计算偏移量($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 $page == 1, 'isLast' => $page == $pages, 'range' => range($start, $end),];
}
调用示例:
立即学习“PHP免费学习笔记(深入)”;
$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输出):
<a href="?page=1" >首页 <a href="?page=" >上一页<a href="?page=" >
<a href="?page=" >下一页<a href="?page=" >末页
几个容易踩的坑
实际写的时候常被忽略,但一出错就整页崩:
$_GET['page'] 没过滤:必须转成整型并限制最小值,否则可能传入负数或SQL注入风险总记录数没缓存:COUNT(*) 在大数据表上很慢,可考虑用近似值或加缓存(如Redis存10分钟)没处理空结果:当 $pages == 0 时,$pagination['range'] 会报错,函数里已用 $pages ?: 1 防御URL参数拼接混乱:建议统一提取除 page 外的其他参数,生成 $queryStr = http_build_query($params)
基本上就这些。逻辑清晰、边界守好,分页就稳了。
以上就是PHP实现分页功能教学_PHP通用分页逻辑示例的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1342174.html
微信扫一扫
支付宝扫一扫