PHP 記憶體優化匯出 MySQL 到 Excel：零依賴 fputcsv 方案

痛點：PHPExcel 記憶體爆炸

PHPExcel/PhpSpreadsheet 功能強大但記憶體消耗極大（每儲存格約 1KB+），匯出 10 萬筆資料輕易突破 256MB 限制。針對大量資料匯出，**串流式 CSV 輸出**是最佳選擇：記憶體佔用恆定、無第三方依賴、Excel 可直接開啟。

核心方案：fputcsv + php://output 串流輸出

<?php
// 1. 設定 HTTP 標頭：觸發瀏覽器下載
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment; filename="export_' . date('Ymd_His') . '.csv"');
header('Cache-Control: max-age=0');

// 2. 開啟輸出串流
$fp = fopen('php://output', 'w');

// 3. 輸出 BOM (解決 Excel 開啟 UTF-8 CSV 亂碼)
fwrite($fp, "\xEF\xBB\xBF");

// 4. 寫入標題列
$headers = ['姓名', '性別', '年齡', 'Email', '電話', '建立時間'];
// Excel 相容性：轉為 GBK/Big5 (或保持 UTF-8 + BOM)
$headers = array_map(function($v) { return iconv('UTF-8', 'GBK//IGNORE', $v); }, $headers);
fputcsv($fp, $headers);

// 5. 分批查詢 + 串流寫入 (關鍵：避免一次性載入所有資料)
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass', [
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_NUM,
    PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false,  // 關鍵：使用非緩衝查詢
]);

$stmt = $pdo->query('SELECT name, gender, age, email, phone, created_at FROM users WHERE status = 1');

$batchSize = 1000;  // 每 1000 筆刷新一次輸出緩衝
$count = 0;

while ($row = $stmt->fetch()) {
    // 編碼轉換
    $row = array_map(function($v) { 
        return iconv('UTF-8', 'GBK//IGNORE', $v); 
    }, $row);
    
    fputcsv($fp, $row);
    
    // 定期刷新輸出緩衝，避免記憶體堆積
    if (++$count % $batchSize === 0) {
        ob_flush();
        flush();
    }
}

fclose($fp);
exit;

關鍵技術點深度解析

進階優化：大檔案分片下載

// 超過 100 萬筆建議分片：每片 5 萬筆，前端輪詢下載合併
// 控制器回傳 JSON: { chunk: 1, total: 20, url: '/export/chunk/1' }
// 前端 JS 依序下載 Blob，最後合併觸發單一檔案下載

常見問題排查

1. Excel 開啟亂碼：確認輸出 BOM (\xEF\xBB\xBF) + 正確編碼轉換
2. 大數值科學計數法：欄位前加 \t 或 ='1234567890' 強制文字格式
3. 換行符被截斷：fputcsv 自動包裹雙引號，資料中若含雙引號會自動轉義
4. Nginx 代理截斷輸出：設定 proxy_buffering off; fastcgi_buffering off;
5. 執行逾時：set_time_limit(0); 或分批次非同步處理

效能對比實測 (10 萬筆、6 欄位)

結論：極大量資料 (>50萬筆) 首選 MySQL SELECT ... INTO OUTFILE (需 FILE 權限)；應用層匯出 fputcsv + 非緩衝查詢 是通用最佳方案。