PHP mysqli 查詢結果解析兩大方法：fetch_object 與 fetch_array 實戰對比

PHP mysqli 查詢結果解析兩大方法：fetch_object 與 fetch_array 實戰對比

執行 SELECT 查詢後，需將 mysqli_result 物件逐行轉為可用資料。PHP 提供兩種主流風格：物件導向（fetch_object）與陣列導向（fetch_array/fetch_assoc）。本文對比兩者用法、效能與適用場景。

一、方法一：fetch_object() — 物件風格

$sql = "SELECT name, brief FROM cars";
$result = $mysqli->query($sql);

while ($row = $result->fetch_object()) {
    echo $row->name . ' - ' . $row->brief . "
";
}
// 欄位名即物件屬性，語意清晰，適合領域模型映射

特點

• 返回 stdClass 物件，屬性名 = 欄位名（區分大小寫）。
• 程式碼可讀性高：$row->name 類似實體屬性存取。
• 可指定類別名稱：fetch_object('CarEntity') 直接映射到自訂類別（需類別屬性為 public 或有 __set）。

二、方法二：fetch_array() / fetch_assoc() — 陣列風格

$sql = "SELECT name, brief FROM cars";
$result = $mysqli->query($sql);

// 1. 數字索引 + 關聯索引（預設 MYSQLI_BOTH）
while ($row = $result->fetch_array()) {
    echo $row[0] . ' - ' . $row[1] . "
";      // 數字索引
    echo $row['name'] . ' - ' . $row['brief'] . "
"; // 關聯索引
}

// 2. 僅關聯索引（推薦，節省記憶體）
while ($row = $result->fetch_assoc()) {
    echo $row['name'] . ' - ' . $row['brief'] . "
";
}

特點

• fetch_array(MYSQLI_ASSOC) 等同 fetch_assoc()，僅返回關聯陣列，記憶體佔用較小。
• fetch_array(MYSQLI_NUM) 僅返回數字索引陣列。
• 陣列操作靈活，易於 json_encode、array_map 等陣列函式處理。

三、效能與記憶體對比（百萬行測試參考）

實際專案中差異微小，**建議統一團隊風格**；若需高效能大量資料處理，考慮 fetch_assoc + 生成器（yield）逐行處理避免佔滿記憶體。

四、完整資源管理範本

function queryAll($mysqli, $sql) {
    $res = $mysqli->query($sql);
    if ($res === false) throw new Exception($mysqli->error);
    if (!$res instanceof mysqli_result) return []; // 非 SELECT

    $data = [];
    while ($row = $res->fetch_assoc()) { // 或 fetch_object()
        $data[] = $row;
    }
    $res->free(); // 釋放結果集記憶體
    return $data;
}

五、進階：多結果集處理

// 預處理多條 SQL（如 CALL stored_proc() 返回多個結果集）
$mysqli->multi_query("CALL get_dashboard_data()");
do {
    if ($res = $mysqli->store_result()) {
        while ($row = $res->fetch_assoc()) { /* 處理第 1 個結果集 */ }
        $res->free();
    }
} while ($mysqli->more_results() && $mysqli->next_result());