异常教程
PHP mysqli_fetch_all() 函数（长文讲解）
💡一则或许对你有用的小广告
欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论
- 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于
Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;- 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;
截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观
前言
在 PHP 开发中，与数据库交互是核心任务之一。当执行 SQL 查询后，如何高效地获取并处理返回的结果集，是开发者需要掌握的关键技能。mysqli_fetch_all() 函数正是为此而生，它简化了遍历数据库结果的流程，尤其适合需要一次性获取所有数据的场景。对于编程初学者和中级开发者而言，理解这一函数不仅能提升代码效率，还能为后续学习更复杂的数据库操作打下基础。本文将通过循序渐进的方式，结合实际案例和形象比喻，深入解析 PHP mysqli_fetch_all() 函数的原理、用法及最佳实践。
函数基础：什么是 mysqli_fetch_all()？
比喻理解：从“逐行取书”到“一网打尽”
假设你正在图书馆查找书籍，传统方法是逐本翻找（如 mysqli_fetch_assoc()），而 mysqli_fetch_all() 相当于一次性将所有符合条件的书籍装进一个大箱子里，方便后续统一处理。这个函数的作用，就是将数据库查询结果直接转换为 PHP 数组，省去了逐行遍历的步骤。
函数语法与参数
mysqli_fetch_all(result $result, int $resulttype = MYSQLI_BOTH): array|false
$result：必须是通过mysqli_query()或mysqli_store_result()获取的数据库查询结果资源。$resulttype：可选参数，定义返回数组的类型，默认为MYSQLI_BOTH。
返回值类型
该函数返回一个包含所有行的二维数组，或在失败时返回 false。例如：
// 成功时的返回结构示例
[
[0 => 1, "id" => 1, 1 => "Alice", "name" => "Alice"],
[0 => 2, "id" => 2, 1 => "Bob", "name" => "Bob"]
]
核心参数详解：resulttype 的三种模式
resulttype 参数决定了返回数组的结构，共有三种模式：
| 模式值 | 对应常量 | 描述 |
|---|---|---|
MYSQLI_ASSOC | MYSQLI_ASSOC | 仅返回关联数组（键为列名） |
MYSQLI_NUM | MYSQLI_NUM | 仅返回数值索引数组（键为数字） |
MYSQLI_BOTH | MYSQLI_BOTH | 同时返回关联和数值索引（键名重复时，数值索引后移） |
示例对比
// 假设查询结果包含两列：id 和 name
// 使用 MYSQLI_ASSOC
$array_assoc = mysqli_fetch_all($result, MYSQLI_ASSOC);
// 结果：[ ["id" => 1, "name" => "Alice"], ... ]
// 使用 MYSQLI_NUM
$array_num = mysqli_fetch_all($result, MYSQLI_NUM);
// 结果：[ [1, "Alice"], ... ]
// 使用默认的 MYSQLI_BOTH
$array_both = mysqli_fetch_all($result);
// 结果：[ [0 => 1, "id" => 1, 1 => "Alice", "name" => "Alice"], ... ]
实战案例：从连接到结果获取
步骤 1：连接数据库
$host = "localhost";
$username = "root";
$password = "";
$dbname = "test_db";
// 创建连接
$conn = new mysqli($host, $username, $password, $dbname);
// 检查连接
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
步骤 2：执行查询并获取结果
// 执行 SELECT 查询
$sql = "SELECT id, name, email FROM users";
$result = $conn->query($sql);
// 检查查询结果
if (!$result) {
die("查询失败: " . $conn->error);
}
步骤 3：使用 mysqli_fetch_all() 获取数据
// 默认模式（MYSQLI_BOTH）
$users_both = $result->fetch_all();
// 关联模式（仅列名作为键）
$users_assoc = $result->fetch_all(MYSQLI_ASSOC);
// 输出关联数组
foreach ($users_assoc as $user) {
echo "ID: " . $user['id'] . ", Name: " . $user['name'] . "<br>";
}
与传统方法的对比：为何选择 mysqli_fetch_all()？
对比 1：逐行遍历 vs 一次性获取
传统方法（使用 mysqli_fetch_assoc()）
while ($row = mysqli_fetch_assoc($result)) {
// 处理每一行数据
}
这种方式需要循环遍历每一行，适合数据量较小或需要即时处理的场景。
新方法（mysqli_fetch_all()）
$rows = mysqli_fetch_all($result, MYSQLI_ASSOC);
// 直接操作整个数组
优点：
- 简化代码结构：一次性获取所有数据，适合需要多次遍历或复杂处理的场景。
- 提高效率：避免循环中反复调用函数，尤其在大数据量时性能更优。
对比 2：与旧扩展 mysql_* 的区别
PHP 已弃用 mysql_* 系列函数（如 mysql_fetch_array()），而 mysqli_* 是其面向对象的改进版本。mysqli_fetch_all() 是 mysql 扩展中 mysql_fetch_array() 的升级替代方案，支持更多功能和安全性。
进阶技巧与注意事项
技巧 1：结合 array_column() 快速提取数据
// 获取所有用户的 email 列
$emails = array_column(mysqli_fetch_all($result, MYSQLI_ASSOC), 'email');
技巧 2：结合 json_encode() 输出 JSON
// 将查询结果转换为 JSON 格式
echo json_encode(mysqli_fetch_all($result, MYSQLI_ASSOC));
注意事项
- 内存限制：当数据量极大时，一次性获取可能占用过多内存，需权衡使用场景。
- 结果集资源：调用
fetch_all()后，结果集资源会被消耗，无法再次使用。 - PHP 版本兼容性：此函数要求 PHP 5.3+，且部分模式（如
MYSQLI_ASSOC）在 PHP 7.0+ 中才支持。
常见问题解答
问题 1：如何在旧版 PHP 中兼容 MYSQLI_ASSOC？
在 PHP 5.3 到 7.0 之间，MYSQLI_ASSOC 可能不被识别，可改用 MYSQLI_NUM 或 MYSQLI_BOTH，或升级 PHP 版本。
问题 2：fetch_all() 与 fetch_array() 的区别？
fetch_all()返回二维数组，包含所有行。fetch_array()每次返回一行数据，需结合循环使用。
结论
PHP mysqli_fetch_all() 函数通过简化数据获取流程，显著提升了开发效率，尤其适合需要一次性处理所有查询结果的场景。通过理解其参数模式、结合实际案例练习，并注意内存管理和版本兼容性，开发者可以更自信地将其融入项目中。无论是处理用户列表、订单数据，还是生成统计报表，这一函数都能成为数据库操作中的得力工具。
建议读者通过以下步骤实践：
- 在本地环境搭建测试数据库；
- 使用
mysqli_fetch_all()替换原有逐行遍历代码； - 对比不同模式下的输出结果，理解其差异。
掌握这一函数，不仅能优化代码结构，更能为后续学习更高级的数据库交互技术（如 PDO）打下坚实基础。