PHP如何实现分页功能_PHP实现分页功能方法【开发】-php教程-PHP中文网

PHP分页核心是计算offset=(page-1)per_page与limit，需校验page为正整数、per_page白名单限制，COUNT()单独查询，PDO预处理防注入但LIMIT参数须强转整型后拼接，分页HTML要处理省略与边界，URL需保留非page参数，大数据量应改用游标分页。

php如何实现分页功能_php实现分页功能方法【开发】

PHP分页的核心逻辑是计算 offset 和 limit

分页不是靠某个函数自动完成的，本质是控制 SQL 查询的起始位置和返回条数。关键参数只有两个：page（当前页码）和per_page（每页数量），由此算出offset = (page - 1) * per_page，再传给SELECT ... LIMIT offset, limit。

常见错误是把page直接当 offset 用，比如第 2 页写成 LIMIT 2, 10，实际应为 LIMIT 10, 10。务必校验page是否为正整数，否则可能触发负数 offset 或 SQL 注入。

page必须过滤：用(int)$_GET['page']或filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT)，再判断是否 > 0
per_page建议硬编码或白名单限制（如只允许 10/20/50），避免用户传入超大值拖垮数据库
查询总记录数必须单独执行SELECT COUNT(*)，不能依赖mysqli_num_rows()查全部数据后截取——大数据量下会 OOM

用 PDO 预处理防止 SQL 注入

手动拼接LIMIT参数时，PDO 不支持对LIMIT子句占位符绑定，所以offset和limit必须先转成整型再拼入 SQL，但其他条件（如搜索关键词）仍要用?占位符。

SELECT id, title FROM article 
WHERE status = ? AND title LIKE ? 
ORDER BY created_at DESC 
LIMIT ?, ?

执行时按顺序传参：$stmt->execute([$status, "%$keyword%", $offset, $per_page])。注意$offset和$per_page必须是整型，且已做过范围校验。

不要用mysql_real_escape_string（已废弃）或addslashes处理数字参数，它们对整型无效且误导逻辑
如果用 MySQLi，bind_param('sisi', $status, $keyword, $offset, $per_page) 中$offset和$per_page仍需提前强转(int)
某些旧版 MySQL 严格模式下，LIMIT ?单参数写法不被支持，必须用双参数LIMIT ?, ?

生成分页 HTML 时要处理边界情况

页码导航不是简单循环输出 1~总页数。真实场景中总页数可能上百，必须做省略（如显示“1 … 5 6 7 … 100”），且当前页要高亮、首尾页要固定可点。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

核心变量就三个：$current_page、$total_pages、$max_show（最多显示几个页码按钮，比如 5）。算法上优先保证当前页居中，再向两边扩展，不足则补首尾。

当$total_pages 时，直接输出 1 到$total_pages
否则计算起始页：$start = max(1, $current_page - floor($max_show / 2))，再根据$start + $max_show - 1是否超过$total_pages来右移
@#@#@#@#@#@#@#@#@#@0和@#@#@#@#@#@#@#@#@#@1必须存在，哪怕总页数只有 1
上一页/下一页链接要加disabled类或禁用逻辑，避免page=0或page=101这类无效链接被点击

前端传参不干净会导致跳页失败

用户从搜索页点分页，URL 很可能是/list.php?keyword=php&page=2。如果分页链接只写?page=3，会丢失keyword参数，导致第 3 页查的是全量数据。

解决方法是保留原始$_GET中除page外的所有键值，再拼进新链接。用http_build_query(array_diff_key($_GET, ['page' => 0]))最稳妥，比正则替换或手动拼接更可靠。

不要用$_SERVER['QUERY_STRING']直接替换，它可能含 URL 编码混乱或空值
如果用了重写规则（如/list/php/3），后端解析时也要确保page能被正确提取，且其他参数不丢失
移动端常有缓存问题：点第 2 页后返回再点第 3 页，浏览器可能加载第 2 页缓存，建议在分页链接加&t== time() ?>或设置Cache-Control: no-cache

分页看着简单，但offset越界、SQL 注入、URL 参数丢失、页码溢出这四点，任一没兜住就会在上线后突然崩掉。尤其是数据量涨到百万级时，LIMIT 1000000, 20这种语句会让 MySQL 扫描一百万行才返回结果——这时候得换游标分页，而不是死磕 page number。