PHP mysqli_fetch_row() 函数（手把手讲解）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 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/ ;

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

在 PHP 开发中，与数据库的交互是应用程序的核心功能之一。当我们使用 MySQLi（MySQL Improved）扩展执行查询时，如何高效地遍历和处理查询结果是一个关键问题。mysqli_fetch_row() 函数作为 PHP 中用于获取查询结果行的核心工具，能够帮助开发者快速实现数据的提取和展示。无论是展示用户列表、处理订单信息，还是构建复杂的分页逻辑，这个函数都是不可或缺的工具。本文将从基础概念到实际应用，系统性地讲解 mysqli_fetch_row() 的用法和技巧，并通过案例帮助读者深入理解其工作原理。

函数基础：语法与核心概念

语法结构

mysqli_fetch_row() 函数的语法如下：

mixed mysqli_fetch_row(mysqli_result $result)  

该函数接受一个 mysqli_result 类型的参数（即查询结果集），并返回当前结果集中的一行数据。返回的数据以 数字索引的数组 形式呈现，其中索引对应数据库表中字段的顺序。例如，若查询的字段为 id, name, email，则返回的数组形式为 [0 => id, 1 => name, 2 => email]。

关键概念：结果集与行的映射

可以将数据库查询的结果集想象为一个“快递分拣中心”：

• 查询：相当于向数据库发送一个请求包裹（SQL 语句）。
• 结果集：数据库返回的包裹群，每个包裹对应一条记录（数据行）。
• mysqli_fetch_row()：如同分拣员逐个拆开包裹，将每个包裹的内容（数据行）按顺序整理到货架上（数组）。

通过循环调用 mysqli_fetch_row()，可以逐行提取所有数据，直到没有更多行可读取为止。

使用场景与示例代码

场景 1：基础数据遍历

假设有一个名为 users 的数据库表，包含 id, username, email 字段。以下代码展示了如何通过 mysqli_fetch_row() 获取并遍历所有用户数据：

// 连接数据库  
$mysqli = new mysqli("localhost", "username", "password", "database");  
if ($mysqli->connect_error) {  
    die("Connection failed: " . $mysqli->connect_error);  
}  

// 执行查询  
$result = $mysqli->query("SELECT id, username, email FROM users");  

// 遍历结果集  
while ($row = $mysqli->fetch_row()) {  
    echo "ID: " . $row[0] . "<br>";  
    echo "Username: " . $row[1] . "<br>";  
    echo "Email: " . $row[2] . "<hr>";  
}  

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

场景 2：动态生成 HTML 表格

在实际开发中，常需要将查询结果以表格形式展示。以下代码演示了如何使用 mysqli_fetch_row() 生成 HTML 表格：

// 假设查询结果已存储在 $result 变量中  
echo "<table border='1'>";  
echo "<tr><th>ID</th><th>Username</th><th>Email</th></tr>";  

while ($row = $result->fetch_row()) {  
    echo "<tr>";  
    echo "<td>" . $row[0] . "</td>";  
    echo "<td>" . $row[1] . "</td>";  
    echo "<td>" . $row[2] . "</td>";  
    echo "</tr>";  
}  
echo "</table>";  

对比其他函数：为何选择 mysqli_fetch_row()？

在 PHP 中，除了 mysqli_fetch_row()，还有 mysqli_fetch_assoc() 和 mysqli_fetch_array() 等函数用于提取结果行。它们的核心区别在于返回的数据结构：

比喻说明：

• mysqli_fetch_row() 类似于“按座位号点名”，直接通过数字索引快速定位。
• mysqli_fetch_assoc() 相当于“按姓名点名”，更直观但可能需要更多内存存储键名。
• mysqli_fetch_array() 则像“同时记录座位号和姓名”，功能全面但效率略低。

选择建议：

• 若字段顺序固定且无需频繁修改代码，优先使用 mysqli_fetch_row()。
• 若需要通过字段名访问数据（如动态表单），则选择 mysqli_fetch_assoc()。

错误处理与注意事项

1. 空结果集的检测

如果查询返回空结果（例如 SELECT * FROM users WHERE id=999），mysqli_fetch_row() 将返回 false。此时需通过 if 语句判断结果是否存在：

if ($row = $result->fetch_row()) {  
    // 处理数据  
} else {  
    echo "没有找到相关记录！";  
}  

2. 内存与性能优化

当处理大规模数据时（如百万级记录），逐行读取可能引发内存问题。可通过以下方法优化：

• 分页查询：使用 LIMIT 子句限制每次查询的行数。
• 及时释放资源：在遍历结束后调用 $result->free() 释放结果集内存。

3. 避免资源耗尽

未关闭数据库连接或未释放结果集可能导致资源泄漏。务必在代码末尾添加：

$result->free();  
$mysqli->close();  

高级技巧：结合预处理语句

在需要执行参数化查询时（如防止 SQL 注入），可与 mysqli_stmt_bind_result() 配合使用。例如：

$stmt = $mysqli->prepare("SELECT id, username FROM users WHERE id = ?");  
$stmt->bind_param("i", $user_id);  
$stmt->execute();  

// 绑定结果变量  
$stmt->bind_result($id, $username);  

while ($stmt->fetch()) {  
    echo "ID: $id, Username: $username<br>";  
}  
$stmt->close();  

此方法通过绑定结果变量逐行提取数据，避免了直接使用 mysqli_fetch_row() 时可能的数组索引混乱问题。

性能优化与最佳实践

1. 减少循环内的重复操作

在循环内部避免执行高开销操作（如数据库查询或文件写入），应将这些操作移到循环外部。例如：

// 不佳实践  
while ($row = $result->fetch_row()) {  
    $another_query = $mysqli->query("SELECT ..."); // 不要在循环中执行此操作  
}  

// 优化后  
$another_query = $mysqli->query("SELECT ...");  
while ($row = $result->fetch_row()) {  
    // 使用 $another_query 的结果  
}  

2. 缓存与批处理

对于频繁查询的静态数据，可考虑使用缓存（如 Redis 或 Memcached）减少数据库压力。同时，批量操作（如插入或更新）比逐行操作更高效。

常见问题与解决方案

Q1: 调用 mysqli_fetch_row() 后返回 NULL

原因：通常是因为结果集未正确初始化，或查询未成功执行。
解决方法：

• 检查 $result 是否为 false（查询失败时返回）。
• 确保在调用 fetch_row() 前已正确执行查询。

Q2: 数组索引与字段顺序不一致

原因：字段顺序可能因 SELECT 语句的顺序变化而改变。
解决方法：

• 在代码中明确指定字段顺序。
• 使用 mysqli_fetch_assoc() 通过字段名访问数据。

Q3: 内存溢出错误

原因：处理大量数据时未释放资源。
解决方法：

• 使用分页查询。
• 及时调用 $result->free()。

结论：掌握 mysqli_fetch_row() 的实际价值

mysqli_fetch_row() 函数是 PHP 开发者与数据库交互的核心工具之一。通过理解其语法、应用场景及优化技巧，开发者可以高效地实现数据读取、展示和处理。无论是构建简单的用户列表，还是处理复杂的数据分析任务，掌握这一函数都能显著提升开发效率。

下一步行动建议：

1. 尝试将现有项目中的 mysqli_fetch_assoc() 改为 mysqli_fetch_row()，观察性能差异。
2. 实践分页逻辑，结合 LIMIT 子句优化大数据查询。
3. 阅读 PHP 官方文档中关于 MySQLi 的扩展说明，深入理解其底层机制。

通过持续练习和优化，mysqli_fetch_row() 将成为你 PHP 开发工具箱中不可或缺的“瑞士军刀”。