如何使用 mysqli_result::field_count 获取 MySQL 查询结果集中字段的总数？

M66 2025-07-18

在 PHP 中，当我们使用 MySQLi 扩展执行数据库查询时，通常需要知道返回结果集中包含多少个字段（列）。这在需要动态处理查询结果（例如构建表格或导出数据）时特别有用。

mysqli_result::field_count 是 mysqli_result 类的一个属性，用来获取查询结果集中字段的总数。本文将介绍它的用法，并通过代码示例帮助你更好地理解。

什么是 mysqli_result::field_count？

mysqli_result::field_count 是一个只读属性，用来表示查询结果集中字段的数量。注意，这个数量是列的数量，而不是返回的行数。

语法：

$number_of_fields = $result->field_count;

其中，$result 是 mysqli_query 或 $mysqli->query() 返回的 mysqli_result 对象。

示例：获取查询结果的字段数量

以下是一个完整的示例，演示如何使用 mysqli_result::field_count 获取查询结果中的字段数量。

<?php
// 数据库连接信息
$host = 'localhost';
$user = 'root';
$password = 'your_password';
$database = 'your_database';

// 创建连接
$mysqli = new mysqli($host, $user, $password, $database);

// 检查连接是否成功
if ($mysqli->connect_error) {
    die('连接失败: ' . $mysqli->connect_error);
}

// 执行查询
$query = "SELECT id, name, email FROM users";
$result = $mysqli->query($query);

// 检查查询是否成功
if ($result) {
    // 获取字段数量
    $field_count = $result->field_count;
    echo "查询结果中包含的字段数量: $field_count\n";

    // 可选：遍历字段名
    while ($field = $result->fetch_field()) {
        echo "字段名: " . $field->name . "\n";
    }

    // 释放结果集
    $result->free();
} else {
    echo "查询失败: " . $mysqli->error;
}

// 关闭连接
$mysqli->close();
?>

示例说明

我们连接到数据库，执行一个 SELECT 查询。
通过 $result->field_count 获取返回字段的总数。
使用 fetch_field() 方法遍历字段详情，输出每个字段的名字。
最后，释放结果集并关闭数据库连接。

使用场景

动态表格渲染：当你需要在网页上渲染查询结果为表格时，提前知道列数可以帮助你动态生成表头。
导出工具：在导出 CSV、Excel 时，需要遍历字段名作为第一行。
调试和日志：在开发阶段，记录查询返回的字段数量有助于排查错误。

mysqli_result