PHP实现分页功能教学_PHP通用分页逻辑示例

分页本质是通过当前页码和每页条数计算偏移量($offset = ($page – 1) * $pageSize)来实现数据截取;文中提供了一个纯PHP可复用分页函数,返回包含总页数、页码范围、上下页状态等完整信息的数组,并强调需过滤输入、缓存总数、处理空结果及规范URL参数拼接。

php实现分页功能教学_php通用分页逻辑示例

分页的核心其实是算两个数

分页不是什么黑科技,本质就靠两个关键数字:当前页码($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);
<pre class='brush:php;toolbar:false;'>$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 < $pages,
    'isFirst'   => $page == 1,
    'isLast'    => $page == $pages,
    'range'     => range($start, $end),
];
登录后复制

}

调用示例:

立即学习PHP免费学习笔记(深入)”;


jquery右侧在线QQ客服+手风琴特效

jquery右侧在线QQ客服+手风琴特效

此作品是一款非常实用的jquery特效,实现了右侧在线QQ客服+手风琴功能,应用范围很广,网站在线客服,或称做网上前台,是一种以网站为媒介,向互联网访客与网站内部员工提供即时沟通的页面通信技术,所以很多网站都可以用到在线客服特效,此作品还带了手风琴分组显示功能,非常实用,php中文网推荐下载!

jquery右侧在线QQ客服+手风琴特效
75


查看详情
jquery右侧在线QQ客服+手风琴特效

$total = $pdo->query("SELECT COUNT(*) FROM articles")->fetchColumn();
$pagination = getPagination($total, $_GET['page'] ?? 1, 12);
<p>// 查询数据
$stmt = $pdo->prepare("SELECT * FROM articles ORDER BY id DESC LIMIT ?, ?");
$stmt->execute([$pagination['offset'], $pagination['pageSize']]);
$articles = $stmt->fetchAll();</p>
登录后复制

前端分页HTML可以很简单

不用JS也能做出清爽的页码栏。注意几点:

  • 当前页加 class=”active” 样式突出
  • 首页、末页、上一页、下一页按钮要判断是否禁用(比如第1页时“上一页”应灰掉或不链接)
  • 页码太多时只显示局部(上面函数里的 $maxShow 就是干这个的)
  • URL参数保留其他查询条件,例如 ?category=php&page=3

简单模板片段(PHP输出):

<div class="pagination">
  <a href="?page=1<?= $queryStr ?>" <?=$pagination['isFirst'] ? 'disabled' : ''?>>首页</a>
  <a href="?page=<?= $pagination['page']-1 ?><?= $queryStr ?>" <?=$pagination['hasPrev'] ? '' : 'disabled'?>>上一页</a>
<p><?php foreach ($pagination['range'] as $p): ?>
<a href="?page=<?= $p ?><?= $queryStr ?>" <?= $p == $pagination['page'] ? 'class="active"' : '' ?>><?= $p ?></a>
<?php endforeach; ?></p><p><a href="?page=<?= $pagination['page']+1 ?><?= $queryStr ?>" <?=$pagination['hasNext'] ? '' : 'disabled'?>>下一页</a>
<a href="?page=<?= $pagination['pages'] ?><?= $queryStr ?>" <?=$pagination['isLast'] ? 'disabled' : ''?>>末页</a>
</div></p>
登录后复制

几个容易踩的坑

实际写的时候常被忽略,但一出错就整页崩:

  • $_GET[‘page’] 没过滤:必须转成整型并限制最小值,否则可能传入负数或SQL注入风险
  • 总记录数没缓存:COUNT(*) 在大数据表上很慢,可考虑用近似值或加缓存(如Redis存10分钟)
  • 没处理空结果:当 $pages == 0 时,$pagination[‘range’] 会报错,函数里已用 $pages ?: 1 防御
  • URL参数拼接混乱:建议统一提取除 page 外的其他参数,生成 $queryStr = http_build_query($params)

基本上就这些。逻辑清晰、边界守好,分页就稳了。

以上就是PHP实现分页功能教学_PHP通用分页逻辑示例的详细内容,更多请关注php中文网其它相关文章!

https://www.php.cn/faq/1830810.html

发表回复

Your email address will not be published. Required fields are marked *