异常教程

PHP mysqli_num_rows() 函数（一文讲透）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

PHP mysqli_num_rows() 函数：数据库查询结果计数的实用指南

在 PHP 开发中，与数据库交互是常见的任务。当我们执行 SQL 查询后，如何快速获取返回结果的行数？此时，mysqli_num_rows() 函数便成为开发者的重要工具。本文将从基础用法、常见问题、进阶技巧和实际案例四个维度，深入解析这一函数的使用场景与核心逻辑，帮助开发者高效完成数据统计工作。

一、函数基础：从 SQL 查询到行数统计

1.1 函数定义与核心作用

mysqli_num_rows() 是 PHP 中用于获取 MySQL 查询结果集中行数的函数。它的核心作用是：在执行 SELECT 查询后，返回结果集中的记录总数。这类似于图书馆管理员清点某类书籍的数量，通过该函数，开发者可以快速了解查询是否返回了预期的数据量。

1.2 基础语法与参数说明

函数语法如下：

int mysqli_num_rows(mysqli_result $result)
  • 参数：$result 是通过 mysqli_query() 或 mysqli_store_result() 等函数返回的结果集对象。
  • 返回值：整数类型，表示结果集中的行数。若结果集为空，则返回 0。

1.3 使用步骤示例

以下是一个简单的用户登录验证场景，演示如何统计匹配记录的数量：

// 连接数据库
$mysqli = new mysqli("localhost", "username", "password", "database");

// 检查连接
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}

// 用户输入
$username = $_POST['username'];
$password = $_POST['password'];

// SQL 查询语句
$sql = "SELECT * FROM users WHERE username = ? AND password = ?";
$stmt = $mysqli->prepare($sql);
$stmt->bind_param("ss", $username, $password);
$stmt->execute();
$result = $stmt->get_result();

// 统计匹配记录数
$num_rows = mysqli_num_rows($result);

if ($num_rows > 0) {
    echo "登录成功！";
} else {
    echo "用户名或密码错误！";
}

// 关闭连接
$stmt->close();
$mysqli->close();

二、常见问题与解决方案

2.1 错误：未正确执行查询

问题现象：调用 mysqli_num_rows() 时提示 Call to a member function on bool。

原因分析：若查询语句语法错误或执行失败，mysqli_query() 返回 false，此时直接传递给 mysqli_num_rows() 会导致错误。

解决方案：

// 检查查询是否成功执行
if ($result = mysqli_query($mysqli, $sql)) {
    $count = mysqli_num_rows($result);
    mysqli_free_result($result); // 释放结果集
} else {
    echo "查询失败: " . mysqli_error($mysqli);
}

2.2 注意事项：结果集的生命周期

  • 资源释放：使用 mysqli_free_result() 显式释放结果集内存，避免内存泄漏。
  • 顺序依赖：必须在关闭数据库连接前调用 mysqli_num_rows()，否则会触发 mysqli_result 对象无效的错误。

2.3 比喻理解：图书馆借阅系统

想象一个图书馆借阅系统，mysqli_query() 相当于向管理员请求一本指定书名的书籍，而 mysqli_num_rows() 则是管理员告诉你该书的可借阅副本数量。如果书名错误（查询失败），管理员无法提供有效信息，此时需要检查输入的准确性。

三、进阶技巧与最佳实践

3.1 结合条件判断优化代码

在需要判断记录是否存在时，直接检查 num_rows 是否大于 0：

if (mysqli_num_rows($result) > 0) {
    // 处理存在记录的逻辑
} else {
    // 处理无记录的情况
}

3.2 统计总记录数的替代方案

对于大数据量场景，若仅需统计总数，可改用 SQL 内置的 COUNT() 函数，减少结果集传输的开销：

$sql = "SELECT COUNT(*) AS total FROM users";
$result = mysqli_query($mysqli, $sql);
$row = mysqli_fetch_assoc($result);
$total = $row['total'];

3.3 与分页功能的结合

在实现分页功能时，mysqli_num_rows() 可用于计算总页数：

// 总记录数
$total_rows = mysqli_num_rows($result);
// 每页显示 10 条
$per_page = 10;
$total_pages = ceil($total_rows / $per_page);

四、实际应用场景与代码案例

4.1 用户注册邮箱验证

在用户注册时，检查邮箱是否已被占用：

$email = $_POST['email'];
$sql = "SELECT id FROM users WHERE email = ?";
$stmt = $mysqli->prepare($sql);
$stmt->bind_param("s", $email);
$stmt->execute();
$result = $stmt->get_result();
if (mysqli_num_rows($result) > 0) {
    echo "该邮箱已被注册！";
} else {
    // 执行注册逻辑
}

4.2 统计文章分类下的文章数量

$category_id = 5;
$sql = "SELECT COUNT(*) FROM articles WHERE category_id = ?";
$stmt = $mysqli->prepare($sql);
$stmt->bind_param("i", $category_id);
$stmt->execute();
$result = $stmt->get_result();
$row = $result->fetch_assoc();
echo "分类 {$category_id} 下共有文章：{$row['COUNT(*)']} 篇";

4.3 错误处理与调试技巧

在开发过程中，建议添加错误日志记录：

if (!$result) {
    $error = "SQL Error: " . mysqli_error($mysqli) . " | Query: $sql";
    error_log($error);
    echo "系统错误，请稍后再试！";
}

五、与类似函数的对比

5.1 mysqli_num_rows() vs. count()

  • mysqli_num_rows()：直接操作数据库结果集，适用于大型数据集。
  • count()：需要将结果集转换为数组（如 fetch_all()），适合小规模数据或内存充足场景。

示例对比：

// 使用 mysqli_num_rows()
$num_rows = mysqli_num_rows($result);

// 使用 count()
$rows = $result->fetch_all();
$count = count($rows);

5.2 mysqli_num_rows() vs. SQL COUNT()

  • mysqli_num_rows()：直接统计结果集的行数，适用于已获取完整数据的情况。
  • SQL COUNT()：通过 SQL 层计算，减少数据传输量，适合仅需统计总数的场景。

六、性能优化建议

6.1 避免不必要的查询

仅在必要时调用 mysqli_num_rows()，例如在登录验证或数据存在性检查中。

6.2 使用预处理语句防止 SQL 注入

始终使用预处理语句（prepare/bind_param）代替字符串拼接，避免 SQL 注入风险。

6.3 结合索引优化查询速度

在统计高频查询的字段（如用户表的 username）时，确保其上有索引，以提升查询效率。

结论

PHP mysqli_num_rows() 函数是开发者与数据库交互中的核心工具之一，它简化了结果集的统计流程，但需注意其依赖的有效结果集和资源管理。通过结合预处理语句、错误处理和性能优化策略，开发者可以构建出高效、安全且易维护的数据库交互逻辑。建议读者在实际项目中通过具体案例反复练习，逐步掌握该函数的深层用法与最佳实践。

通过本文的讲解，希望读者能够全面理解 PHP mysqli_num_rows() 函数的原理与应用场景。在后续开发中，建议结合项目需求，灵活运用本文提到的技术要点，提升数据库操作的效率与可靠性。

最新发布

查看更多文章