遍历 mysqli_result 所有结果的正确姿势

M66 2025-05-28

在使用 PHP 进行数据库操作时，mysqli 扩展提供了非常方便的函数来连接、查询以及操作数据库。mysqli_result 是在执行查询时返回的结果集对象。本文将介绍如何正确遍历 mysqli_result 函数返回的所有结果，以便能够高效地获取和处理查询结果。

1. 连接数据库

首先，我们需要通过 mysqli_connect() 函数来连接数据库。这里假设你已经具备了基本的 MySQL 数据库操作经验，下面是一个简单的数据库连接示例：

<?php
$servername = "localhost";
$username = "root";
$password = "";
$dbname = "test_db";

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检查连接
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
?>

2. 执行查询

连接到数据库后，我们可以通过 mysqli_query() 来执行 SQL 查询。假设我们查询一个名为 users 的表，并获取所有用户的信息：

$sql = "SELECT id, name, email FROM users";
$result = $conn->query($sql);

此时，$result 将是一个 mysqli_result 对象，包含查询的所有数据。

3. 使用 mysqli_fetch_assoc() 遍历结果

最常见的遍历 mysqli_result 返回的结果集的方法是使用 mysqli_fetch_assoc() 函数。该函数会返回一个关联数组，每次调用时，它会返回一行数据，并将指针移动到下一行，直到没有更多数据为止。

if ($result->num_rows > 0) {
    // 输出每一行的数据
    while($row = $result->fetch_assoc()) {
        echo "id: " . $row["id"]. " - Name: " . $row["name"]. " - Email: " . $row["email"]. "<br>";
    }
} else {
    echo "0 结果";
}

在这个例子中，mysqli_fetch_assoc() 返回的是一个关联数组，其中数组的键是字段名，值是对应字段的值。

4. 使用 mysqli_fetch_row() 遍历结果

除了 mysqli_fetch_assoc()，你还可以使用 mysqli_fetch_row() 来返回一个索引数组，每一行数据的字段值将按顺序存放在数组中。使用这种方法时，需要通过索引来访问各个字段的值。

if ($result->num_rows > 0) {
    // 输出每一行的数据
    while($row = $result->fetch_row()) {
        echo "id: " . $row[0] . " - Name: " . $row[1] . " - Email: " . $row[2] . "<br>";
    }
} else {
    echo "0 结果";
}

这里 mysqli_fetch_row() 返回的是一个数字索引数组，$row[0] 对应的是 id 字段，$row[1] 是 name，$row[2] 是 email。

5. 使用 mysqli_fetch_object() 遍历结果

如果你更习惯于对象的方式来处理查询结果，可以使用 mysqli_fetch_object()。它会返回一个对象，每个字段都可以通过对象属性来访问。

if ($result->num_rows > 0) {
    // 输出每一行的数据
    while($row = $result->fetch_object()) {
        echo "id: " . $row->id . " - Name: " . $row->name . " - Email: " . $row->email . "<br>";
    }
} else {
    echo "0 结果";
}

6. 遍历所有结果的另一种方式

如果你需要在处理过程中更灵活地操作所有行的数据，可以使用 mysqli_fetch_all() 函数，它会返回一个包含所有结果的二维数组。

$allResults = $result->fetch_all(MYSQLI_ASSOC);

foreach ($allResults as $row) {
    echo "id: " . $row["id"] . " - Name: " . $row["name"] . " - Email: " . $row["email"] . "<br>";
}

这里 fetch_all(MYSQLI_ASSOC) 会返回所有结果作为一个关联数组。

7. 关闭连接

操作完成后，记得关闭数据库连接：

$conn->close();

总结

通过上述几种方式，我们可以遍历 mysqli_result 函数返回的所有结果。具体使用哪种方式取决于个人的需求和数据的处理方式。如果你希望通过关联数组获取字段，可以使用 mysqli_fetch_assoc()；如果更倾向于对象的方式，可以选择 mysqli_fetch_object()；如果你需要同时处理所有行的数据，可以使用 mysqli_fetch_all()。

记住，数据库连接操作后要及时关闭连接，以保证资源的释放。