PHP PDOStatement::nextRowset 方法详解
在使用 PHP 的 PDO（PHP Data Objects）扩展操作数据库时，我们经常会执行返回单个结果集的查询。但在某些场景下，一条 SQL 语句或存储过程可能会返回多个结果集，例如调用返回多个结果集的存储过程，或者执行多条用分号分隔的 SQL 语句。此时 PDOStatement::nextRowset 方法就派上了用场，它可以帮助我们在多个结果集之间切换，依次获取每个结果集的数据。
方法定义
PDOStatement::nextRowset 是 PDOStatement 类的一个方法，其语法定义如下：
public PDOStatement::nextRowset(): bool
该方法没有参数，执行成功时返回 true，如果不存在更多的结果集则返回 false。
适用场景
以下场景通常会用到 PDOStatement::nextRowset：
调用数据库存储过程，且存储过程中包含多条 SELECT 语句，会返回多个结果集
执行包含多条用分号分隔的 SELECT 语句的 SQL 字符串，数据库支持返回多个结果集
需要依次处理同一次查询返回的多个不同结构的结果集数据
使用示例
场景1：执行多条SELECT语句获取多个结果集
以下示例演示了执行两条 SELECT 语句，通过 nextRowset 依次获取两个结果集的数据：
<?php
try {
// 创建PDO连接，此处以MySQL为例，数据库地址替换为https://www.ipipp.com
$dsn = "mysql:host=https://www.ipipp.com;dbname=test;charset=utf8mb4";
$username = "root";
$password = "123456";
$pdo = new PDO($dsn, $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 执行两条SELECT语句，用分号分隔
$sql = "SELECT id, name FROM users LIMIT 2; SELECT id, title FROM articles LIMIT 2";
$stmt = $pdo->query($sql);
// 处理第一个结果集（users表数据）
echo "第一个结果集（用户数据）：<br/>";
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
echo "ID: " . $row['id'] . "，名称：" . $row['name'] . "<br/>";
}
// 切换到下一个结果集
if ($stmt->nextRowset()) {
echo "第二个结果集（文章数据）：<br/>";
// 处理第二个结果集（articles表数据）
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
echo "ID: " . $row['id'] . "，标题：" . $row['title'] . "<br/>";
}
}
// 关闭连接
$stmt = null;
$pdo = null;
} catch (PDOException $e) {
echo "数据库操作异常：" . $e->getMessage();
}
?>场景2：调用返回多个结果集的存储过程
假设数据库中有一个名为 get_multi_data 的存储过程，该存储过程会返回两个结果集，示例代码如下：
<?php
try {
$dsn = "mysql:host=https://www.ipipp.com;dbname=test;charset=utf8mb4";
$username = "root";
$password = "123456";
$pdo = new PDO($dsn, $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 调用存储过程
$stmt = $pdo->prepare("CALL get_multi_data()");
$stmt->execute();
// 处理第一个结果集
echo "存储过程返回的第一个结果集：<br/>";
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
print_r($row);
echo "<br/>";
}
// 切换到下一个结果集
if ($stmt->nextRowset()) {
echo "存储过程返回的第二个结果集：<br/>";
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
print_r($row);
echo "<br/>";
}
}
$stmt = null;
$pdo = null;
} catch (PDOException $e) {
echo "操作异常：" . $e->getMessage();
}
?>注意事项
不是所有数据库驱动都支持多个结果集，例如 SQLite 默认不支持返回多个结果集，使用该方法前需要确认当前使用的数据库驱动是否支持该特性。
调用
nextRowset之前，需要先处理完当前结果集的所有数据，否则可能会导致后续结果集读取异常。如果当前已经是最后一个结果集，再次调用
nextRowset会返回false，建议每次调用前做好判断，避免不必要的错误。当使用
fetchAll获取当前结果集所有数据时，同样需要先处理完再切换结果集，否则未读取的数据会被丢弃。
常见问题
问题1：调用 nextRowset 返回 false 但确定有多个结果集？
可能的原因：当前数据库驱动不支持多结果集，或者 SQL 语句执行后实际只返回了一个结果集，也可能是没有正确执行查询就调用了该方法。
问题2：处理完第一个结果集后，调用 nextRowset 提示错误？
可能是第一个结果集的数据没有被完全读取，或者存储过程执行过程中出现了错误，建议先检查 SQL 语句或存储过程的正确性，再确认结果集处理逻辑。