萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP MySQL 緩衝查詢與非緩衝查詢深度解析:mysql/mysqli/PDO 三驅動對比

核心概念

查詢結果集存放位置決定了「緩衝」與「非緩衝」:

  • 緩衝查詢:結果集完整從 MySQL 服務器傳輸到 PHP 客戶端內存,PHP 驅動緩存所有行。隨機訪問、多次遍歷、獲取行數 num_rows 皆可。缺點:大結果集佔用 PHP 進程內存,易 OOM。
  • 非緩衝查詢:結果集留在 MySQL 服務端,PHP 逐行拉取 (fetch)。優點:PHP 內存佔用恆定 (僅當前行)。缺點:不可隨機訪問、不可 num_rows、未讀完前不能發送新查詢 (佔用連接)。

三大驅動默認行為與切換方式

驅動默認模式啟用緩衝啟用非緩衝
mysql (已棄用)緩衝默認mysql_unbuffered_query()
mysqli非緩衝mysqli_query($link, $sql, MYSQLI_STORE_RESULT) 或 $stmt->store_result()默認 / MYSQLI_USE_RESULT
PDO_MySQL非緩衝$pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, true)默認

完整代碼對比演示

<?php
$dbConfig = [
    'host' => '127.0.0.1', 'port' => 3306,
    'user' => 'root', 'pass' => '', 'db' => 'test',
];
$sql = 'SELECT * FROM large_table'; // 假設 100萬行

// ---------- mysql (已棄用,僅示意) ----------
$link = mysql_connect(...);
mysql_select_db($dbConfig['db']);

// 緩衝 (默認)
$res = mysql_query($sql, $link);
while ($row = mysql_fetch_assoc($res)) { /* ... */ }
mysql_free_result($res);

// 非緩衝
$res = mysql_unbuffered_query($sql, $link);
while ($row = mysql_fetch_assoc($res)) { /* ... */ }
// 無法 mysql_num_rows($res)

// ---------- mysqli ----------
$mysqli = new mysqli(...);

// 非緩衝 (默認)
$res = $mysqli->query($sql); // MYSQLI_USE_RESULT
while ($row = $res->fetch_assoc()) { /* ... */ }
$res->free();

// 緩衝
$res = $mysqli->query($sql, MYSQLI_STORE_RESULT);
echo $res->num_rows; // 可用
while ($row = $res->fetch_assoc()) { /* ... */ }
$res->free();

// 預處理語句默認非緩衝,需 store_result()
$stmt = $mysqli->prepare($sql);
$stmt->execute();
$stmt->store_result(); // 緩衝到客戶端
echo $stmt->num_rows;
$stmt->bind_result($col1, $col2);
while ($stmt->fetch()) { /* ... */ }

// ---------- PDO ----------
$pdo = new PDO("mysql:host={$dbConfig['host']};dbname={$dbConfig['db']}", $dbConfig['user'], $dbConfig['pass']);

// 非緩衝 (默認)
$stmt = $pdo->query($sql);
foreach ($stmt as $row) { /* ... */ } // 流式讀取

// 緩衝
$pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, true);
$stmt = $pdo->query($sql);
$rows = $stmt->fetchAll(); // 全部載入內存
// 或
$stmt = $pdo->prepare($sql);
$stmt->execute();
$rows = $stmt->fetchAll();

內存佔用實測 (100萬行,單行約 200 字節)

// 緩衝查詢
memory_get_peak_usage() ≈ 200 MB+  // 直接 OOM 風險

// 非緩衝查詢
memory_get_peak_usage() ≈ 2-4 MB   // 僅當前行 + 驅動緩衝區

選型決策樹

結果集大小?
  ├─ 小 (< 1萬行 / < 10MB) → 緩衝查詢 (默認即可,代碼簡單,支援 num_rows/seek)
  └─ 大 / 未知 / 串流處理 → 非緩衝查詢
       需要 num_rows 或多次遍歷?
         ├─ 是 → 緩衝查詢 (或先 COUNT(*) 再非緩衝)
         └─ 否 → 非緩衝查詢 (foreach 遍歷即可)
併發高、長連接池?
  → 非緩衝佔用連接時間長,慎用;或用緩衝快速釋放連接

最佳實踐建議

  1. 默認使用 PDO + 非緩衝 (foreach 遍歷):內存安全、代碼簡潔、支援預處理防注入。
  2. 需要總行數:先執行 SELECT COUNT(*) ...,再非緩衝查詢數據。
  3. 大數據導出 CSV:非緩衝 + fputcsv(STDOUT) 流式輸出,內存恆定。
  4. 避免在非緩衝查詢未結束時發起新查詢:會報 Commands out of sync,需先 fetchAll 或 free_result。
  5. mysqli 預處理:execute() 後默認非緩衝,若需 num_rows 必須調用 store_result()。

總結

理解緩衝/非緩衝本質是「結果集存在客戶端還是服務端」。PHP 現代開發首選 PDO 非緩衝流式處理,配合 COUNT(*) 獲取總數,兼顧內存安全與代碼簡潔。僅在明確需要隨機訪問、多次遍歷且結果集較小的場景才顯式啟用緩衝模式。

copyright © 萬盛學電腦網 all rights reserved