0

0

mysqli_num_rows返回什么_获取查询结果行数的方法【教程】

星夢妙者

星夢妙者

发布时间:2026-03-08 17:03:11

|

784人浏览过

|

来源于php中文网

原创

mysqli_num_rows返回结果集行数,仅适用于select等查询;对insert/update/delete返回0;若未缓冲结果集或未调用mysqli_store_result(),即使有数据也返回0。

mysqli_num_rows返回什么_获取查询结果行数的方法【教程】

mysqli_num_rows 返回的是一个整数,表示结果集中包含的行数——但仅当查询是 SELECTSHOWDESCRIBEEXPLAIN 这类返回结果集的语句时才有效;对 INSERTUPDATEDELETE 等语句,它返回 0,哪怕你误用了它。

为什么 mysqli_num_rows 有时返回 0,明明查到了数据?

最常见原因是:没调用 mysqli_store_result() 或没走完整结果获取流程。在使用 mysqli_query() 后,如果直接对返回的 mysqli_result 对象调用 mysqli_num_rows(),看起来没问题,但前提是这个结果集必须是“缓冲”的(buffered)。

而如果你用的是 mysqli_use_result(),或者启用了无缓冲查询(比如设置了 MYSQLI_STORE_RESULT 以外的选项),结果集不会被一次性读入内存,mysqli_num_rows() 就无法预知总行数,只能返回 0。

Julius AI
Julius AI

Julius AI是一款功能强大的AI数据分析工具,可以快速分析和可视化复杂数据。

下载
  • 默认情况下 mysqli_query() 是缓冲查询,mysqli_num_rows() 可用
  • 但若手动调用 mysqli_use_result(),就必须先遍历完结果,或改用 mysqli_fetch_all() 再取 count()
  • 注意:PDO 的 rowCount() 在 SELECT 上行为不同(多数驱动不支持,返回 -1),别混用

mysqli_num_rowsmysqli_affected_rows 到底该用哪个?

这是新手最容易混淆的一对函数。它们根本不是替代关系,而是服务完全不同的场景:

  • mysqli_num_rows() 只用于 SELECT 类查询,告诉你“查出来多少行”
  • mysqli_affected_rows() 用于 INSERT/UPDATE/DELETE,告诉你“影响了多少行”(包括被更新但值没变的行)
  • SELECT 调用 mysqli_affected_rows(),返回值是 -1(表示不适用)
  • 对无变化的 UPDATE(比如 SET name='a' WHERE name='a'),mysqli_affected_rows() 可能返回 0 —— 这是正常行为,不代表出错

性能和兼容性:什么时候不该依赖 mysqli_num_rows

当结果集很大时,mysqli_num_rows() 虽然只是读一个内部计数器,但前提是结果集已缓冲。如果用 mysqli_query() 获取了大结果却没消费,会占用大量内存;更糟的是,有些托管环境限制了单次查询内存,可能直接报 Out of memory 错误。

  • 只查总数?直接写 SELECT COUNT(*) FROM ...,比 SELECT * + mysqli_num_rows() 快得多也省资源
  • 需要分页且数据量大?避免先查全量再用 mysqli_num_rows() 算总页数,改用 SQL_CALC_FOUND_ROWS(已弃用)或两次查询(COUNT(*) + LIMIT
  • PHP 8.1+ 中,mysqli_result 对象的 num_rows 属性(如 $result->num_rows)和函数等价,但属性访问稍快,且更符合现代写法

真正容易被忽略的是:它不校验数据有效性,也不感知 SQL 注入或权限问题——返回 5 行,不代表这 5 行都该给你看;返回 0,也不代表没数据,可能只是查询失败后你没检查 mysqli_error() 就直接用了结果对象。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1110

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

380

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2089

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

380

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1642

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

439

2024.04.29

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

59

2026.03.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2.5万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 845人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号