PHPExcel 已於 2017 年停止維護,現代專案應改用 **PhpSpreadsheet**。本文以 PhpSpreadsheet 為主,示範從 Composer 安裝、讀取現有 Excel、建立新檔案匯出資料、設定樣式、多工作表等完整實務操作。
composer require phpoffice/phpspreadsheet
// 入口檔
require_once 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
use PhpOffice\PhpSpreadsheet\Writer\Xls;
$inputFile = './test.xlsx';
try {
$reader = IOFactory::createReaderForFile($inputFile);
$reader->setReadDataOnly(true); // 僅讀資料,忽略樣式/圖表,省記憶體
$spreadsheet = $reader->load($inputFile);
} catch (Exception $e) {
die('載入失敗: ' . $e->getMessage());
}
$sheet = $spreadsheet->getSheet(0); // 第一個工作表
$highestRow = $sheet->getHighestRow();
$highestCol = $sheet->getHighestColumn();
$highestColIdx = \PhpOffice\PhpSpreadsheet\Cell\Coordinate::columnIndexFromString($highestCol);
for ($row = 1; $row <= $highestRow; $row++) {
$rowData = $sheet->rangeToArray("A{$row}:{$highestCol}{$row}", null, true, false);
// $rowData[0] 為該列陣列,直接處理...
var_dump($rowData);
}
$spreadsheet = new Spreadsheet();
// 文件屬性 (可在檔案總管右鍵內容查看)
$props = $spreadsheet->getProperties();
$props->setCreator('作者名')
->setLastModifiedBy('最後修改者')
->setTitle('文件標題')
->setSubject('主題')
->setDescription('描述')
->setKeywords('關鍵字')
->setCategory('分類');
// 第一張工作表
$sheet = $spreadsheet->getActiveSheet();
$sheet->setTitle('第一個工作表');
// 寫入資料 (座標寫法)
$sheet->setCellValue('A1', '你好')
->setCellValue('B2', '世界')
->setCellValue('C1', '你好')
->setCellValue('D2', '世界');
// 多國語言/特殊符號 (UTF-8 直接寫入)
$sheet->setCellValue('A4', 'Miscellaneous glyphs')
->setCellValue('A5', 'éàèùâêîôûüÿäöüç');
// 多行文字 + 自動換行 + 行高自適應
$value = "-Value A\n-Value B\n-Value C";
$sheet->setCellValue('A8', '你好世界');
$sheet->getRowDimension(8)->setRowHeight(-1); // -1 = 自動高度
$sheet->getStyle('A8')->getAlignment()->setWrapText(true);
$sheet->setCellValue('A10', $value);
$sheet->getRowDimension(10)->setRowHeight(-1);
$sheet->getStyle('A10')->getAlignment()->setWrapText(true);
$sheet->getStyle('A10')->setQuotePrefix(true); // 強制視為文字,避免科學記號
// 新增第二張工作表
$sheet2 = $spreadsheet->createSheet();
$sheet2->setTitle('第二個工作表');
$sheet2->setCellValue('A1', 'Sheet 2 Data');
// 匯出 .xlsx (Office 2007+)
$writer = new Xlsx($spreadsheet);
$writer->save('export.xlsx');
// 匯出 .xls (Office 97-2003 相容)
$writer = new Xls($spreadsheet);
$writer->save('export.xls');
echo '匯出完成';
| 需求 | 程式碼片段 |
|---|---|
| 欄寬自動 | $sheet->getColumnDimension('A')->setAutoSize(true); |
| 標題列凍結 | $sheet->freezePane('A2'); |
| 儲存格樣式 (粗體、底色、框線) | $sheet->getStyle('A1:D1')->applyFromArray([ 'font'=>['bold'=>true], 'fill'=>['fillType'=>\PhpOffice\PhpSpreadsheet\Style\Fill::FILL_SOLID, 'startColor'=>['rgb'=>'FFFF00']], 'borders'=>['allBorders'=>['borderStyle'=>\PhpOffice\PhpSpreadsheet\Style\Border::BORDER_THIN]] ]); |
| 數值格式 (千分位、百分比、日期) | $sheet->getStyle('B2:B100')->getNumberFormat()->setFormatCode('#,##0'); |
| 大量資料寫入優化 | 使用 fromArray() 批次寫入,避免逐 cell setCellValue;關閉 $spreadsheet->setPreCalculateFormulas(false)。 |
| 記憶體優化 (超大檔匯出) | 改用 Box/Spout (串流寫入,常駐記憶體 < 10MB) 或分批產生多個檔案壓縮打包。 |
PHPExcel_* → PhpOffice\PhpSpreadsheet\*。IOFactory::createReader('Excel2007') → IOFactory::createReaderForFile($file) 自動偵測。PHPExcel_Style_Alignment::HORIZONTAL_CENTER → \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER。採用 PhpSpreadsheet 並善用 fromArray、ReadDataOnly、樣式陣列套用,能高效完成企業級 Excel 匯入匯出需求。