简体中文
简体中文
在使用 PHP 操作 MySQL 数据库时，调用存储过程是一种常见的做法，尤其当我们希望将复杂的业务逻辑封装在数据库层面时。然而，很多开发者在调用带有**输出参数（OUT 参数）**的存储过程时，往往会遇到读取不到输出参数值的情况。
其中一个关键点就在于 next_result() 的使用。本文将详细解释为何需要调用该函数，以及如何正确读取存储过程的输出参数。
当使用 mysqli 驱动调用一个返回多个结果集（如多个 SELECT 或同时包含 SELECT 和输出参数）的存储过程时，MySQL 会以“多个结果集”的方式返回数据。next_result() 方法用于让 mysqli 驱动准备读取下一个结果集。
如果不显式调用 next_result() 并遍历完所有结果集，某些数据库结果（如输出参数或最终的结果集）将无法被访问。
我们先来看一个简单的 MySQL 存储过程，它有一个输入参数和一个输出参数：
DELIMITER $$
CREATE PROCEDURE get_user_email(IN user_id INT, OUT email VARCHAR(255))
BEGIN
SELECT user_email INTO email FROM users WHERE id = user_id;
END $$
DELIMITER ;
这个存储过程根据用户 ID 查询其邮箱，并通过 OUT 参数返回。
<?php
$mysqli = new mysqli("localhost", "username", "password", "your_database");
// 检查连接
if ($mysqli->connect_error) {
die("连接失败: " . $mysqli->connect_error);
}
// 1. 设置 OUT 参数变量
$mysqli->query("SET @email = ''");
// 2. 调用存储过程
$mysqli->query("CALL get_user_email(1, @email)");
// 3. 必须使用 next_result() 清除结果集
while ($mysqli->more_results()) {
$mysqli->next_result();
$result = $mysqli->store_result();
if ($result) {
$result->free();
}
}
// 4. 获取 OUT 参数
$result = $mysqli->query("SELECT @email AS user_email");
$row = $result->fetch_assoc();
echo "用户邮箱为: " . $row['user_email'];
$mysqli->close();
?>
在调用 CALL 语句后，MySQL 实际上可能返回一个或多个隐式结果集。如果不使用 next_result() 来清除这些结果集，后续的查询（如 SELECT @email）可能会被阻塞或者执行失败。
有些开发者会遇到“读取输出参数为空”的问题，其实并不是存储过程没执行成功，而是前面的结果集没有清除，导致后面的查询根本没执行。
如果你使用的是预处理语句，也可以使用类似逻辑：
$stmt = $mysqli->prepare("CALL get_user_email(?, @email)");
$stmt->bind_param("i", $userId);
$userId = 1;
$stmt->execute();
// 清理所有结果集
do {
if ($result = $stmt->get_result()) {
$result->free();
}
} while ($stmt->more_results() && $stmt->next_result());
// 获取输出参数
$result = $mysqli->query("SELECT @email AS user_email");
$row = $result->fetch_assoc();
echo "用户邮箱为: " . $row['user_email'];
当你使用 CALL 执行存储过程时，无论是否使用输出参数或返回多个结果集，你都应该调用 next_result() 来遍历所有潜在的结果集。
这不仅是良好的实践，更是确保你可以正确读取 OUT 参数的前提条件。牢记这一点，能够帮助你避免很多让人头疼的“结果读取不到”的问题。
有关更多存储过程调用的最佳实践，你可以访问我们的开发指南：https://gitbox.net/docs/mysql/stored-procedures
