查詢結果集存放位置決定了「緩衝」與「非緩衝」:
num_rows 皆可。缺點:大結果集佔用 PHP 進程內存,易 OOM。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();
// 緩衝查詢
memory_get_peak_usage() ≈ 200 MB+ // 直接 OOM 風險
// 非緩衝查詢
memory_get_peak_usage() ≈ 2-4 MB // 僅當前行 + 驅動緩衝區
結果集大小?
├─ 小 (< 1萬行 / < 10MB) → 緩衝查詢 (默認即可,代碼簡單,支援 num_rows/seek)
└─ 大 / 未知 / 串流處理 → 非緩衝查詢
需要 num_rows 或多次遍歷?
├─ 是 → 緩衝查詢 (或先 COUNT(*) 再非緩衝)
└─ 否 → 非緩衝查詢 (foreach 遍歷即可)
併發高、長連接池?
→ 非緩衝佔用連接時間長,慎用;或用緩衝快速釋放連接
SELECT COUNT(*) ...,再非緩衝查詢數據。fputcsv(STDOUT) 流式輸出,內存恆定。Commands out of sync,需先 fetchAll 或 free_result。execute() 後默認非緩衝,若需 num_rows 必須調用 store_result()。理解緩衝/非緩衝本質是「結果集存在客戶端還是服務端」。PHP 現代開發首選 PDO 非緩衝流式處理,配合 COUNT(*) 獲取總數,兼顧內存安全與代碼簡潔。僅在明確需要隨機訪問、多次遍歷且結果集較小的場景才顯式啟用緩衝模式。