PHPExcel 是功能相當完整的 Excel 文件產生類庫,需要輸出複雜格式時很好用,代價是 API 相對繁瑣。以下把常用操作整理成一份可參照的清單。
<?php
// 設定 include path
set_include_path('.'. PATH_SEPARATOR .
'D:\Zeal\PHP_LIBS' . PATH_SEPARATOR .
get_include_path());
require_once 'PHPExcel.php';
// 依輸出版本決定寫入器,擇一載入
////require_once 'PHPExcel/Writer/Excel5.php'; // 舊版 xls
////require_once 'PHPExcel/Writer/Excel2007.php'; // 2007 格式
$objExcel = new PHPExcel();
// $objWriter = new PHPExcel_Writer_Excel5($objExcel);
$objProps = $objExcel->getProperties();
$objProps->setCreator("Zeal Li");
$objProps->setLastModifiedBy("Zeal Li");
$objProps->setTitle("Office XLS Test Document");
$objProps->setSubject("Office XLS Test Document, Demo");
$objProps->setDescription("Test document, generated by PHPExcel.");
$objProps->setKeywords("office excel PHPExcel");
$objProps->setCategory("Test");
$objExcel->setActiveSheetIndex(0); // 預設已建立 SheetIndex=0
$objActSheet = $objExcel->getActiveSheet();
$objActSheet->setTitle('測試Sheet');
// 由 PHPExcel 自動判斷型別
$objActSheet->setCellValue('A1', '字串內容');
$objActSheet->setCellValue('A2', 26); // 數值
$objActSheet->setCellValue('A3', true); // 布林
$objActSheet->setCellValue('A4', '=SUM(A2:A2)'); // 公式
// 明確指定型別,避免長數字被當成數值處理
$objActSheet->setCellValueExplicit('A5', '847475847857487584',
PHPExcel_Cell_DataType::TYPE_STRING);
$objActSheet->mergeCells('B1:C22'); // 合併
$objActSheet->unmergeCells('B1:C22'); // 分離
$objActSheet->getColumnDimension('B')->setAutoSize(true);
$objActSheet->getColumnDimension('A')->setWidth(30);
$objStyleA5 = $objActSheet->getStyle('A5');
// 數字格式:避免大數字被顯示成科學記號
$objStyleA5->getNumberFormat()
->setFormatCode(PHPExcel_Style_NumberFormat::FORMAT_NUMBER);
// 字型
$objFontA5 = $objStyleA5->getFont();
$objFontA5->setName('Courier New');
$objFontA5->setSize(10);
$objFontA5->setBold(true);
$objFontA5->setUnderline(PHPExcel_Style_Font::UNDERLINE_SINGLE);
$objFontA5->getColor()->setARGB('FF999999');
// 對齊
$objAlignA5 = $objStyleA5->getAlignment();
$objAlignA5->setHorizontal(PHPExcel_Style_Alignment::HORIZONTAL_RIGHT);
$objAlignA5->setVertical(PHPExcel_Style_Alignment::VERTICAL_CENTER);
// 邊框
$objBorderA5 = $objStyleA5->getBorders();
$objBorderA5->getTop()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);
$objBorderA5->getTop()->getColor()->setARGB('FFFF0000');
/objBorderA5->getBottom()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);
$objBorderA5->getLeft()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);
$objBorderA5->getRight()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);
// 填色
$objFillA5 = $objStyleA5->getFill();
$objFillA5->setFillType(PHPExcel_Style_Fill::FILL_SOLID);
$objFillA5->getStartColor()->setARGB('FFEEEEEE');
// 從 A5 複製樣式到 B1:C22
$objActSheet->duplicateStyle($objStyleA5, 'B1:C22');
$objDrawing = new PHPExcel_Worksheet_Drawing();
$objDrawing->setName('ZealImg');
$objDrawing->setDescription('Image inserted by Zeal');
$objDrawing->setPath('./zeali.net.logo.gif');
$objDrawing->setHeight(36);
$objDrawing->setCoordinates('C23');
$objDrawing->setOffsetX(10);
$objDrawing->setRotation(15);
$objDrawing->getShadow()->setVisible(true);
$objDrawing->getShadow()->setDirection(36);
$objDrawing->setWorksheet($objActSheet);
$objExcel->createSheet();
$objExcel->getSheet(1)->setTitle('測試2');
$objExcel->getSheet(1)->getProtection()->setSheet(true);
$objExcel->getSheet(1)->protectCells('A1:C22', 'PHPExcel');
$outputFileName = "output.xls";
// $objWriter->save($outputFileName); // 存檔
// 或直接輸出到瀏覽器
header("Content-Type: application/octet-stream");
header('Content-Disposition: inline;filename="'.$outputFileName.'"');
header("Content-Transfer-Encoding: binary");
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header("Pragma: no-cache");
$objWriter->save('php://output');
第一,使用 Excel5 寫入器時輸出內容應為 GBK 編碼,否則中文會亂碼。第二,若用 Excel5 且把數字格式設為 FORMAT_NUMBER,實際輸出會未套用「0」格式,這是 PHPExcel_Style_NumberFormat 的常數定義與 Excel5 寫入器不相容所致。解法是修改 PHPExcel_Writer_Excel5_Format 類別中的 getXf($style) 方法,在 if ($this->_BIFF_version == 0x0500) 判斷之前補上一行:
if ($ifmt === '0') $ifmt = 1;
另外提醒,PHPExcel 已停止維護,後繼方案是 PhpSpreadsheet。新專案建議直接採用後者,API 更一致且支援 PHP 新版本。