mysqli_num_rows获取查询结果行数教程

`mysqli_num_rows()` 是 PHP 中用于获取 SELECT 类查询结果集行数的关键函数，但其行为高度依赖查询类型、结果集缓冲状态及正确调用流程：它仅对 SELECT/SHOW/DESCRIBE/EXPLAIN 有效，对 INSERT/UPDATE/DELETE 恒返 0；若未缓冲结果（如误用 `mysqli_use_result()`）或未完整获取结果，即使数据存在也会返回 0；新手常混淆的 `mysqli_affected_rows()` 则专用于写操作，二者不可互换；性能上，大结果集下盲目依赖 `mysqli_num_rows()` 易致内存溢出，应优先用 `COUNT(*)` 替代全量查询；更需警惕的是——它不验证 SQL 安全性、不反映查询成败，返回值为 0 或正数绝不等于逻辑正确，务必配合 `mysqli_error()` 检查错误。

mysqli_num_rows 返回的是一个整数，表示结果集中包含的行数——但仅当查询是 SELECT、SHOW、DESCRIBE 或 EXPLAIN 这类返回结果集的语句时才有效；对 INSERT、UPDATE、DELETE 等语句，它返回 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。

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

mysqli_num_rows 和 mysqli_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() 就直接用了结果对象。

理论要掌握，实操不能落！以上关于《mysqli_num_rows获取查询结果行数教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！