PHP mysqli 多语句执行时怎么读取完所有结果集

PHP 的 mysqli::multi_query() 会把多条 SQL 放进同一次请求，但返回给 PHP 的不是一个“自动合并”的结果。连接上可能依次挂着多个结果集，也可能夹着只返回影响行数的 UPDATE 或 INSERT。正确做法是：先处理当前结果，再释放它，确认还有后续结果后调用 next_result()，循环直到结束。

先分清当前结果和后续结果

multi_query() 执行后，mysqli 先把第一条语句的结果交给连接。此时不能直接对同一个连接发起下一次查询；当前结果没有被取完，连接仍处于忙状态。SELECT、SHOW、DESCRIBE 这类语句通常可以用 store_result() 取成 mysqli_result，而 UPDATE、INSERT 没有可遍历的行，只需要检查影响行数或继续切换。

因此循环体应该先处理当前结果。不要把 next_result() 写成循环的第一步，否则第一条结果容易被跳过，也可能留下未消费的结果。

用 more_results 和 next_result 遍历全部结果

下面的示例故意混合两个查询和一个没有结果集的更新语句。代码只适合演示固定 SQL；如果 SQL 中含有用户输入，应改用参数化的预处理语句，不要把输入直接拼进多语句字符串。

set_charset('utf8mb4');

$sql = multi_query($sql);

    do {
        // 有行结果的语句在这里取走，避免连接一直保持忙状态。
        $result = $db->store_result();
        if ($result !== false) {
            while ($row = $result->fetch_assoc()) {
                // 业务代码在这里消费当前结果集。
                var_dump($row);
            }
            // 进入下一个结果前释放当前结果占用的内存。
            $result->free();
        } elseif ($db->errno !== 0) {
            // false 也可能代表当前语句失败，不能当成无结果集忽略。
            throw new RuntimeException($db->error, $db->errno);
        } else {
            // UPDATE/INSERT 没有结果集，但仍可读取影响行数。
            $affected = $db->affected_rows;
        }

        // 没有后续结果时正常结束，不再调用 next_result。
        if (!$db->more_results()) {
            break;
        }
        // 切换失败通常表示后续语句出错；严格模式也会抛异常。
        if (!$db->next_result()) {
            throw new RuntimeException($db->error, $db->errno);
        }
    } while (true);
} finally {
    // 无论中途是否抛错，都关闭连接，避免把资源留给长请求。
    $db->close();
}
?>

这段循环有两个关键点。第一，store_result() 返回 false 不等于失败：没有结果集的更新语句也会走到这里，所以要结合 errno 判断。第二，more_results() 只回答“后面是否还有结果”，真正让连接切换到下一个结果的是 next_result()。

释放结果集后再切换，异常才不会被吞掉

如果结果集较大，先把行消费完并调用 free()，再执行 next_result()。对于只返回影响行数的语句，不要伪造一个 fetch 循环；记录 affected_rows 即可。若启用了 MYSQLI_REPORT_STRICT，mysqli 的操作错误会以异常形式出现，finally 仍然负责关闭连接。

常见问题

可以只调用 next_result，不调用 more_results 吗？

可以设计成依赖 next_result() 结束循环，但必须能区分“没有后续语句”和“后续语句报错”。用 more_results() 先判断，代码意图更清楚。

为什么 store_result 返回 false？

当前语句可能没有结果集，也可能执行失败。检查 errno；不能把所有 false 都当作正常分支。

结果集必须手动释放吗？

建议显式调用 free()，尤其是批量查询和长连接场景。它让资源边界清晰，也避免在切换结果前积累不必要的内存。