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

admin 百科 2025-12-08 16

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

PHP实现分页功能教学_PHP通用分页逻辑示例-第1张图片-佛山资讯网

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

分页不是什么黑科技，本质就靠两个关键数字：当前页码（$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免费学习笔记（深入）”；

标签： mysql php redis html js 前端 go 大数据 sql注入 red