萬盛學電腦網

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

PHP 生成 Excel 的輕量級方案:從 CSV 到 PhpSpreadsheet 進階選型

為什麼不再推薦「偽 Excel」HTML 表格輸出?

早期常見用 header('Content-type:application/vnd.ms-excel') 輸出 HTML 表格偽裝成 .xls,雖然簡單但問題眾多:無法支援公式、樣式易碎、大數據記憶體爆炸、Excel 2007+ 會彈出格式不符警告。現代專案應根據場景選擇正規庫。

方案選型對照表

方案適用場景優點缺點記憶體
fputcsv 輸出 CSV純資料匯出、大數據、無樣式需求極速、記憶體恆定、原生函數無樣式/公式/多工作表、編碼易亂碼O(1)
Box/Spout中大型資料、需基本樣式、.xlsx/.ods流式寫入、記憶體低、無依賴功能較簡單、不支援複雜圖表O(1)
PhpSpreadsheet完整 Excel 功能、樣式/公式/圖表/多表功能最全、社群活躍、格式相容佳記憶體高、大檔案易 OOMO(N)

方案一:原生 fputcsv 串流輸出(推薦大數據)

<?php
function exportCsvStream(array $headers, iterable $data, string $filename = 'export.csv'): void
{
    header('Content-Type: text/csv; charset=UTF-8');
    header('Content-Disposition: attachment; filename="' . $filename . '"');
    header('Pragma: no-cache');
    header('Expires: 0');

    $out = fopen('php://output', 'w');
    // 寫入 BOM 防止 Excel 開啟 UTF-8 亂碼
    fwrite($out, "\xEF\xBB\xBF");
    fputcsv($out, $headers);

    foreach ($data as $row) {
        fputcsv($out, $row);
    }
    fclose($out);
}

// 使用範例:搭配 Generator 逐行查詢資料庫
function getUserGenerator(PDO $pdo): Generator
{
    $stmt = $pdo->query('SELECT id, name, email, created_at FROM users');
    while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
        yield $row;
    }
}

exportCsvStream(['ID', '姓名', 'Email', '註冊時間'], getUserGenerator($pdo), 'users.csv');
?>

方案二:Box/Spout 產出真 .xlsx(平衡功能與效能)

<?php
use Box\Spout\Writer\Common\Creator\WriterEntityFactory;
use Box\Spout\Writer\XLSX\Writer;

require 'vendor/autoload.php';

$writer = Writer::create(WriterEntityFactory::XLSX);
$writer->openToBrowser('users.xlsx');

$writer->addRow(WriterEntityFactory::createRow(['ID', '姓名', 'Email', '註冊時間']));

$stmt = $pdo->query('SELECT id, name, email, created_at FROM users');
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
    $writer->addRow(WriterEntityFactory::createRow($row));
}
$writer->close();
?>

方案三:PhpSpreadsheet 完整功能(小檔案/複雜報表)

<?php
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

$sheet->setCellValue('A1', 'ID')->setCellValue('B1', '姓名')
      ->setCellValue('C1', 'Email')->setCellValue('D1', '註冊時間');

// 樣式範例
$sheet->getStyle('A1:D1')->getFont()->setBold(true);
$sheet->getColumnDimension('C')->setWidth(30);

$row = 2;
$stmt = $pdo->query('SELECT id, name, email, created_at FROM users LIMIT 1000');
while ($data = $stmt->fetch(PDO::FETCH_NUM)) {
    $sheet->fromArray($data, null, "A{$row}");
    $row++;
}

$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
?>

大檔案優化關鍵技巧

  1. 串流寫入:避免一次性載入所有資料到陣列
  2. 分塊查詢:PDO 使用 PDO::MYSQL_ATTR_USE_BUFFERED_QUERY = false + fetch() 逐行
  3. 記憶體限制:ini_set('memory_limit', '512M') 視情況調整
  4. 臨時檔案:PhpSpreadsheet 可設定 $spreadsheet->setPreCalculateFormulas(false) 關閉公式預計算

編碼避坑指南

  • CSV 輸出務必加 UTF-8 BOM:fwrite($out, "\xEF\xBB\xBF")
  • 資料庫連線設定 charset=utf8mb4
  • 含換行/逗號/雙引號的欄位,fputcsv 會自動加雙引號包裹並轉義

總結建議

  • 百萬行以上:唯有 CSV 串流或 Spout
  • 萬行內需樣式/多表:PhpSpreadsheet
  • 介於兩者:Spout 最佳平衡
  • 純後台下載:考慮異步生成 + 簽名 URL 下載,避免阻塞請求
copyright © 萬盛學電腦網 all rights reserved