DIV CSS 佈局教程網

PHPExcel 常用語法整理:從屬性設定到輸出檔案
編輯:關於JavaScript     

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 新版本。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved