當前位置: 首頁> 最新文章列表> 如何利用mysqli_result::fetch_field 函數查看查詢結果的字段結構？全面指南

如何利用mysqli_result::fetch_field 函數查看查詢結果的字段結構？全面指南

gitbox 2025-06-10

在開發基於PHP 的數據庫應用時，我們常常需要了解數據庫查詢結果中字段的結構信息，比如字段名稱、數據類型、最大長度等。這對於動態生成表格、驗證數據格式，甚至自動生成表單元素都非常有幫助。幸運的是，PHP 提供了一個強大的函數—— mysqli_result::fetch_field ，可以幫助我們輕鬆獲取這些字段元數據。

本文將帶你全面了解如何使用mysqli_result::fetch_field函數來查看查詢結果的字段結構，並通過具體的代碼示例來加深理解。

一、什麼是mysqli_result::fetch_field ？

mysqli_result::fetch_field()是mysqli_result類的一個方法，用於返回表示結果集中單個字段信息的對象。每次調用該方法，它都會返回下一個字段的信息，直到沒有更多字段為止。

返回的對像是一個包含多個屬性的stdClass對象，這些屬性包括：

  • name ：字段名

  • orgname ：原始字段名（如果使用了別名）

  • table ：字段所屬的表名

  • orgtable ：原始表名

  • def ：默認值（已廢棄，始終為null ）

  • db ：數據庫名

  • catalog ：數據庫目錄（通常為"def"）

  • max_length ：結果集中該字段的最大長度

  • length ：字段的定義長度

  • charsetnr ：字符集編號

  • flags ：字段的標誌位（如是否為主鍵、是否可以為NULL）

  • type ：字段的類型（如MYSQLI_TYPE_STRING ）

  • decimals ：小數位數

二、基礎使用示例

以下是一個基本的使用示例，展示如何連接數據庫並獲取查詢結果中字段的結構信息。

<code> <?php // 數據庫連接參數$host = "localhost"; $user = "root"; $password = "your_password"; $database = "test_db";

// 建立數據庫連接
$conn = new mysqli($host, $user, $password, $database);

// 檢查連接
if ($conn->connect_error) {
die("連接失敗: " . $conn->connect_error);
}

// 執行查詢
$sql = "SELECT id, username, email FROM users";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
echo "字段結構信息：<br><br>";

 while ($field = $result-&gt;fetch_field()) {
    echo "字段名: " . $field-&gt;name . "&lt;br&gt;";
    echo "隸屬桌子: " . $field-&gt;table . "&lt;br&gt;";
    echo "原始字段名: " . $field-&gt;orgname . "&lt;br&gt;";
    echo "類型: " . $field-&gt;type . "&lt;br&gt;";
    echo "長度: " . $field-&gt;length . "&lt;br&gt;";
    echo "是否可為 NULL: " . ($field-&gt;flags &amp; MYSQLI_NOT_NULL_FLAG ? "否" : "是") . "&lt;br&gt;";
    echo "--------------------------&lt;br&gt;";
}

} else {
echo "沒有結果。";
}

// 關閉連接
$conn->close();
?>
</code>

三、如何理解type與flags

type返回的是一個整數常量，代表字段類型，例如：

  • MYSQLI_TYPE_LONG （整型）

  • MYSQLI_TYPE_VAR_STRING （變長字符串）

  • MYSQLI_TYPE_DATETIME （日期時間）

你可以通過定義一個映射數組來將這些常量轉換為更易讀的文本。

類似地， flags是一個位掩碼，表示字段的各種屬性，如是否為主鍵、是否自動遞增等。你可以使用位運算來判斷某個標誌是否存在。

四、實用技巧

  1. 動態生成表頭：你可以使用fetch_field()來動態地獲取字段名作為HTML 表格的表頭，尤其適用於未知列數的情況。

  2. 字段驗證：在處理用戶輸入或導入數據時，提前獲取字段結構可以幫助驗證字段類型與長度是否符合預期。

  3. 自動化開發：結合字段元數據，開發自動生成表單、數據校驗規則

相關內容