PHP分页功能常见BUG,总页数计算错误怎么修正

大伟小哥_4702

大伟小哥_4702

2026-10-02

333人浏览

原创

总页数计算错误的根本原因是未用ceil()向上取整、每页条数非正整数或删/查后未重算总数;必须三者兼顾:$total_pages = (int)ceil($total_count / $per_page),$per_page ≥ 1,每次操作后按相同where条件重查count(*)并校验$page ≥ 1。

php分页功能常见bug,总页数计算错误怎么修正

总页数算错,根本原因是用了错误的数学方法或没处理边界情况。最稳妥的做法是:用 ceil() 除法、确保每页条数为正整数、每次查询前重新统计总数——三者缺一不可。

总页数必须用 ceil(),不能用 round() 或 int

比如总记录 23 条、每页 10 条,正确总页数是 3(23 ÷ 10 = 2.3 → 向上取整得 3)。若用 (int)(23/10) 得 2,第 3 页就永远无法显示;用 round(23/10) 在 25 条时会得 2(25/10=2.5 → 四舍五入为 2),漏掉最后 5 条。

  • ✅ 正确写法:$total_pages = (int)ceil($total_count / $per_page);
  • ❌ 避免:(int)($total_count / $per_page)、round($total_count / $per_page)、floor()
  • 注意:$per_page 为 0 或负数时,PHP 会警告或结果异常,需提前校验:$per_page = max(1, (int)$_GET['per_page'] ?? 10);

删数据后不重算总数,页码就“悬空”

用户刚删了 15 条记录,但分页仍按旧总数算页码,导致请求 ?page=5 时查不到数据,页面空白。这不是前端按钮禁用能解决的,必须服务端兜底。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

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

下载
  • 执行删除操作后,立刻用 COUNT(*) 重新查一次过滤条件下的真实总数
  • 再算最大合法页码:$max_page = $total_count > 0 ? (int)ceil($total_count / $per_page) : 1;
  • 如果当前 $_GET['page'] > $max_page,直接 302 跳转到 $max_page(或首页)
  • 别复用缓存的总数——尤其在高并发下,删完不刷新,页码错乱概率极高

过滤条件变了,但总页数还按全表算

带分类筛选、搜索关键词、状态过滤的列表,常见错误是:COUNT 总数用的是无 WHERE 的全表统计,而实际数据查询加了 WHERE。结果总数虚高,页码多出几页,点进去全是空。

  • 总数 SQL 和分页数据 SQL 必须共用完全相同的 WHERE 条件
  • 例如筛选 status = 1 AND category_id = 5,COUNT 也得写:SELECT COUNT(*) FROM table WHERE status = 1 AND category_id = 5
  • ThinkPHP 中用 paginate() 时,确保模型查询链已完整添加 where,不要在 paginate 之后补条件
  • 若用原生 SQL,两个查询语句的条件字符串建议抽成变量复用,避免手误

传参非法导致 page 值崩坏,连带总数计算失效

$_GET['page'] 是字符串,未强转就参与计算,会导致 $page = '3abc' 变成 3(还好),但 'abc3' 变成 0,'-5' 变成 -5——offset 成负数,MySQL 直接报错,后续的总数计算甚至不会执行。

  • 统一入口校验:$page = max(1, (int)($_GET['page'] ?? 1));
  • 更安全可用:$page = filter_input(INPUT_GET, 'page', FILTER_SANITIZE_NUMBER_INT); $page = max(1, (int)$page);
  • 数据库查询前先做这步,否则后面所有逻辑(包括总数判断、OFFSET 计算、页码导航生成)都建立在错误基础上

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php教程 php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9784

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5841

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3648

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4354

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3411

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4857

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3782

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11782

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
零基础新手入门PHP教程
零基础新手入门PHP教程

共237课时 | 48.9万人学习

新版php入门教程
新版php入门教程

共85课时 | 49.7万人学习

李炎恢PHP视频教程第一季
李炎恢PHP视频教程第一季

共136课时 | 60.9万人学习