遇到 Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) 別慌。這不只是「記憶體不夠」,更可能是程式邏輯錯誤的信號。本文教您系統化排查根因、精準修復,而非單純調大 memory_limit 掩蓋問題。
| 特徵 | 真記憶體不足 | 程式漏洞 (記憶體洩漏/無限迴圈) |
|---|---|---|
| 錯誤發生時間 | 處理大量資料時 (匯出、圖片處理、大檔案讀取) | 處理少量資料、固定流程、特定輸入即觸發 |
錯誤訊息中的 tried to allocate | 較大 (MB 級) | 極小 (bytes 級) 或固定值 |
| 記憶體成長曲線 | 線性/階梯狀隨資料量增長 | 指數級/鋸齒狀/持續上升不釋放 |
| 重現性 | 資料量達閾值必現 | 特定條件觸發,可能間歇性 |
memory_get_usage(true) (真實分配)、memory_get_peak_usage(true) (峰值)memory_get_usage() 到日誌<?php
function memCheck(string $label): void {
$mem = memory_get_usage(true) / 1024 / 1024;
$peak = memory_get_peak_usage(true) / 1024 / 1024;
error_log("[$label] Current: ${mem}MB, Peak: ${peak}MB");
}
// 使用範例
memCheck('start');
$largeArray = range(1, 1000000);
memCheck('after range');
$processed = array_map(fn($x) => $x * 2, $largeArray);
memCheck('after map');
unset($largeArray);
memCheck('after unset');
gc_collect_cycles();
memCheck('after gc');
// ❌ 一次載入百萬行 -> 記憶體爆炸
$lines = file('huge.log');
foreach ($lines as $line) { process($line); }
// ✅ 生成器逐行讀取 -> 記憶體恆定
function readLines(string $file): Generator {
$handle = fopen($file, 'r');
while (($line = fgets($handle)) !== false) {
yield rtrim($line);
}
fclose($handle);
}
foreach (readLines('huge.log') as $line) { process($line); }
fetchAll() 一次載入全部結果
$stmt = $pdo->prepare('SELECT * FROM huge_table');
$stmt->execute();
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) { // 逐行取得
process($row);
}
unset() 大變數 + gc_collect_cycles():釋放循環引用佔用的記憶體memory_limit (臨時緩解)<?php
// 單一腳本臨時提升 (僅影響當前腳本)
ini_set('memory_limit', '512M'); // 或 '2G', '-1' (無限制,極度危險)
// 檢查當前限制
echo ini_get('memory_limit'); // 128M
; php.ini (生產環境建議 256M-512M)
memory_limit = 256M
; .htaccess (Apache 模組模式)
php_value memory_limit 256M
; .user.ini (PHP-FPM / CGI 模式)
memory_limit = 256M
; Docker / Kubernetes
# Dockerfile
ENV PHP_MEMORY_LIMIT=512M
# 或啟動時覆蓋
CMD php -d memory_limit=512M -S 0.0.0.0:8000
php -i | grep memory_limit 驗證。
php_memory_usage_bytes、php_memory_peak_bytes,超過 80% 告警oom_score_adj 降低 PHP-FPM 被殺優先級,但不可依賴此機制pm.max_requests = 500 防止長期運行洩漏累積opcache.enable=1、opcache.memory_consumption=256,減少編譯記憶體佔用<?php
// ❌ 錯誤:一次查所有、一次建構整個 Spreadsheet 物件
$allData = $pdo->query('SELECT * FROM orders')->fetchAll();
$spreadsheet = new Spreadsheet();
// ... 寫入 10 萬行 -> 記憶體 > 500MB
// ✅ 正確:分批查詢 + 串流寫入
$batchSize = 1000;
$offset = 0;
$spreadsheet = new Spreadsheet();
$writer = new \PhpOffice\PhpSpreadsheet\Writer\Xlsx($spreadsheet);
$writer->setUseDiskCaching(true); // 磁碟暫存
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="orders.xlsx"');
$firstBatch = true;
while (true) {
$stmt = $pdo->prepare('SELECT * FROM orders LIMIT ? OFFSET ?');
$stmt->execute([$batchSize, $offset]);
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (empty($rows)) break;
$sheet = $spreadsheet->getActiveSheet();
if ($firstBatch) {
$sheet->fromArray(array_keys($rows[0]), null, 'A1'); // 表頭
$firstBatch = false;
}
$sheet->fromArray($rows, null, 'A' . ($offset + 2));
$offset += $batchSize;
// 關鍵:定期輸出緩衝區 (需搭配 ob_flush/flush 或直接串流寫入)
// 此處簡化:最終一次性 save('php://output') 但已用磁碟緩存
}
$writer->save('php://output');
Allowed memory size exhausted 是程式健康狀態的體檢報告。優先修復邏輯漏洞 (生成器、分批處理、及時釋放),輔以合理的 memory_limit 設定與監控體系。記住:記憶體是有限資源,演算法決定上限,工程決定下限。