简体中文
简体中文
在 PHP 与 MySQL 的交互过程中，开发者常常会接触到 multi_query() 和 next_result() 这两个函数。但不少初学者在阅读文档或尝试实际开发时，容易混淆这两个函数的用途，甚至误以为 next_result() 可以单独用于执行多条 SQL 语句。
本文将深入探讨这两个函数在 PHP 中的职责、工作机制、使用方式，以及为什么 next_result() 无法替代 multi_query()。
multi_query() 是 PHP mysqli 扩展中的一个函数，它的作用是一次性执行多条 SQL 语句。这些 SQL 语句必须使用分号 (;) 分隔，构成一个长的 SQL 字符串。
$mysqli = new mysqli("localhost", "user", "password", "database");
$sql = "SELECT * FROM users; SELECT * FROM orders;";
if ($mysqli->multi_query($sql)) {
do {
if ($result = $mysqli->store_result()) {
while ($row = $result->fetch_assoc()) {
print_r($row);
}
$result->free();
}
} while ($mysqli->next_result());
} else {
echo "执行失败: " . $mysqli->error;
}
在这个示例中，multi_query() 启动了一个多结果集的处理流程，而后通过 next_result() 来依次访问每一条语句的结果。
next_result() 的职责是让 mysqli 向下一个结果集推进。它不会执行任何 SQL，而只是从已经由 multi_query() 执行后的结果中，向下一个语句的返回结果移动。
也就是说，next_result() 本身不执行 SQL，它只是遍历。
如果没有 multi_query() 的前置调用，next_result() 根本无事可做。它依赖的上下文是“已经执行了多条语句”。
这就像问「为什么不能用遥控器来打开电视，而不插电源？」因为 next_result() 是处理流程的一部分，而不是执行动作的起点。
职责不同
multi_query() 是执行器。
next_result() 是迭代器。
依赖关系
没有 multi_query() 的上下文，调用 next_result() 会返回 false。
next_result() 只在 multi_query() 成功执行后才有意义。
错误处理与状态管理
multi_query() 负责执行和初始化所有语句，出现错误可立即中断。
next_result() 则是处理结果集，它不会重试或重新执行 SQL。
场景：执行多条初始化语句，例如建表与插入数据
$sql = "
CREATE TABLE IF NOT EXISTS logs (id INT AUTO_INCREMENT PRIMARY KEY, message TEXT);
INSERT INTO logs (message) VALUES ('初始化成功');
SELECT * FROM logs;
";
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->multi_query($sql)) {
do {
if ($result = $mysqli->store_result()) {
while ($row = $result->fetch_assoc()) {
echo $row['message'] . "\n";
}
$result->free();
}
} while ($mysqli->next_result());
} else {
echo "执行出错: " . $mysqli->error;
}
你可以把这个应用在如部署脚本、批量初始化数据等场景中。
在 PHP 的数据库编程中，multi_query() 和 next_result() 是配套使用的一对工具。前者负责将多条语句送入数据库执行，后者负责取出每一条语句的执行结果。
试图用 next_result() 来执行 SQL 语句，等同于“只用遥控器开电视但没有插电”，它是无法独立完成任务的。只有充分理解它们各自的职责和上下文，才能写出高效、稳定的数据库交互代码。
如果你还在使用 REST 接口测试多语句执行，例如向 https://gitbox.net/api/sql-exec 提交多条语句，也应记得使用支持多语句的执行方式来模拟 multi_query() 的效果。
