PHP 記憶體耗盡 Fatal error: Allowed memory size 完整解決方案與調優策略

PHP 執行報錯 Fatal error: Allowed memory size of 134217728 bytes exhausted 表示腳本申請記憶體超過 `memory_limit` 設定。本文提供分層級解決方案（配置修改、運行時調整、代碼優化）、記憶體分析工具與預防最佳實踐。

錯誤碼解讀

Allowed memory size of 134217728 bytes exhausted
# 134217728 bytes = 128 MB (預設值)
# 8388608 bytes = 8 MB (舊版預設)

三層級解決方案

層級一：配置檔修改（需管理員權限，永久生效）

# 1. 定位 php.ini
php --ini
# 或 phpinfo() 顯示 Loaded Configuration File

# 2. 修改 memory_limit
memory_limit = 256M  # 建議 256M-512M，-1 代表無限制（危險）

# 3. 重啟服務
systemctl restart php-fpm  # 或 apache2 / nginx

層級二：運行時動態調整（無管理員權限，單腳本生效）

<?php
// 必須在記憶體密集操作之前呼叫
ini_set('memory_limit', '512M');  // 字串格式，單位 M/G/K

// 檢查當前限制
echo 'Current limit: ' . ini_get('memory_limit');

> ⚠️ 若 `php.ini` 設定 `disable_functions = ini_set` 則無效。

層級三：.htaccess / .user.ini（虛擬主機/共享環境）

# .htaccess (Apache)

    php_value memory_limit 256M


# .user.ini (PHP-FPM/通用，目錄級遞歸生效)
memory_limit = 256M

代碼層面記憶體優化核心技巧

問題模式	優化方案	記憶體釋放效果
一次性讀取大檔案	`file_get_contents` → `fopen` + `fgets` 逐行處理 / Generators	從 O(n) 降為 O(1)
大陣列長期駐留	分批處理 + `unset($largeArray)` + `gc_collect_cycles()`	即時釋放
資料庫大結果集	`fetchAll()` → 游標 `fetch()` 迴圈 / PDOStatement::fetch	避免雙份複製
圖片處理 (GD)	處理完立即 `imagedestroy($resource)`	釋放 C 層記憶體
字串大量拼接	`.`= → `[]` 陣列收集最後 `implode()` / `yield`	減少中間複製
Composer autoload 過重	`composer dump-autoload -o` 生成 classmap	減少檔案掃描

記憶體分析與除錯工具

1. 即時監控記憶體使用

<?php
function memUsage(string $label = ''): string {
    $unit = ['B', 'KB', 'MB', 'GB'];
    $mem = memory_get_usage(true); // true = 含系統分配
    $peak = memory_get_peak_usage(true);
    $i = floor(log($mem, 1024));
    return sprintf("%s: 當前 %.2f %s / 峰值 %.2f %s", 
        $label, $mem / 1024**$i, $unit[$i], $peak / 1024**$i, $unit[$i]);
}

// 關鍵節點插入
echo memUsage('讀取檔案前') . "\n";
$data = file('huge.log');
echo memUsage('讀取檔案後') . "\n";
unset($data);
echo memUsage('釋放後') . "\n";

2. Xdebug + WebGrind / QCacheGrind 分析

# php.ini
zend_extension=xdebug.so
xdebug.mode=profile
xdebug.output_dir=/tmp/xdebug
xdebug.profiler_output_name=cachegrind.out.%p

# 執行腳本後分析
webgrind /tmp/xdebug

3. Memory Profiler (PHP 8.0+)

composer require --dev php-memory-profiler/php-memory-profiler

<?php
use MemoryProfiler\MemoryProfiler;
$profiler = new MemoryProfiler();
$profiler->start();
// ... 執行代碼 ...
$report = $profiler->stop();
echo $report->getReport();

常見場景專項對策

• 匯出百萬行 Excel/CSV：使用 fputcsv 逐行寫入檔案流，或 box/spout 串流式寫入器。
• 批次圖片縮圖/水印：單張處理完 `imagedestroy()`，批次間 `sleep(1)` 讓 GC 喘息。
• 遞歸/大型物件圖：改用迭代器模式，避免呼叫堆疊與物件引用鏈過深。
• Composer 依賴過多：移除 `dev` 依賴 `composer install --no-dev`，啟用 APCu 快取 `apc.enable_cli=1`。

預防性架構設計原則

1. 串流優於載入：凡涉及大資料，優先考慮 Generator/Iterator/Stream 流式處理。
2. 邊界限制：所有外部輸入（上傳檔案、API 分頁、查詢 LIMIT）必須設定硬性上限。
3. 監控告警：部署 `php-memory-profiler` 定期採樣，記憶體增長趨勢異常即告警。
4. 容器化限制：Docker `memory_limit` 設定略大於 PHP `memory_limit`，觸發 OOM Kill 而非 PHP Fatal Error，利於容器自動重啟。

結合配置調整、代碼優化、持續監控三位一體，能從根本上解決 PHP 記憶體耗盡問題，保障服務穩定運行。