如何使用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