如何在 next_result() 前使用 use_result() 获取结果集

gitbox 2025-04-29

在使用 PHP 操作 MySQL 的多语句查询时，常会用到 multi_query() 配合 next_result() 来遍历多个结果集。而在调用 next_result() 前，正确地使用 use_result() 是确保结果不被遗漏或错误处理的关键步骤。本文将介绍其正确用法，并给出一个完整的代码示例。

为什么需要 use_result()

在执行多语句查询后，MySQL 会返回多个结果集。PHP 提供了两种方式来获取结果集：store_result() 和 use_result()。其中，use_result() 是非缓冲方式，适用于读取大数据量的结果，它会立刻开始从服务器读取数据。

如果你在处理当前结果集之前就调用了 next_result()，那么当前的结果集就会被 MySQL 丢弃。这将导致你无法访问那些结果，也可能引发错误。因此，必须先调用 use_result() 来获取当前结果集，再进行读取。

正确使用方式

<?php
$mysqli = new mysqli("localhost", "username", "password", "database");

if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}

$sql = "SELECT * FROM users; SELECT * FROM products;";
if ($mysqli->multi_query($sql)) {
    do {
        // 在调用 next_result() 前必须获取当前结果集
        if ($result = $mysqli->use_result()) {
            while ($row = $result->fetch_assoc()) {
                print_r($row);
            }
            $result->free(); // 记得释放结果集资源
        } else {
            echo "当前没有结果集或出错：" . $mysqli->error;
        }
    } while ($mysqli->next_result());
} else {
    echo "查询失败：" . $mysqli->error;
}

$mysqli->close();
?>

注意事项

只调用一次 use_result()：每个结果集只能用一次 use_result()，否则会报错。
释放资源：处理完结果后，一定要调用 $result->free() 来释放内存。
错误检查：use_result() 可能返回 false，应加以判断。

结语

掌握 use_result() 和 next_result() 的正确使用顺序，不仅有助于你在处理多语句查询时避免常见的逻辑错误，还能提高程序的健壮性。如果你在项目中需要调用多个 SQL 查询，并且结果集较大，推荐优先考虑 use_result()，并严格遵守上述流程。

如需了解更多实战技巧，可以访问我们的网站：https://gitbox.net/php-tips

next_result