萬盛學電腦網

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

PHPExcel/PhpSpreadsheet 讀取與匯出 Excel 完整實戰教學

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;

一、讀取 Excel (支援 .xls/.xlsx/.csv/.ods)

$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);
}

二、建立並匯出 Excel (含樣式、合併儲存格、多工作表)

$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 的注意事項

  • 命名空間:PHPExcel_* → PhpOffice\PhpSpreadsheet\*。
  • IOFactory::createReader('Excel2007') → IOFactory::createReaderForFile($file) 自動偵測。
  • PHPExcel_Style_Alignment::HORIZONTAL_CENTER → \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER。
  • 所有類別常數皆改為命名空間常數,IDE 自動完成可快速修正。

採用 PhpSpreadsheet 並善用 fromArray、ReadDataOnly、樣式陣列套用,能高效完成企業級 Excel 匯入匯出需求。

copyright © 萬盛學電腦網 all rights reserved