MIS 腳印 logo

MIS 腳印

記錄 IT 學習的軌跡

PHP 使用 PHPExcel 讀取、寫入並產生篩選功能的 Excel 下載檔

如何在 PHP 使用 PHPExcel 來讀取預先建立好含有篩選功能的 Excel 版型檔案,接著寫入資料並產生有篩選功能的 Excel 下載檔。

PHP

下載 PHPExcel

至 GitHub - PHPOffice / PHPExcel:DEPRECATED 下載壓縮檔,解壓縮至網站根目錄並去除版本號為 PHPExcel。

建立 Excel 版型

由於 PHPExcel 無法設定 Excel 的「篩選功能」,因此要自行先建立一個 Excel 版型檔,先讓 PHPExcel 讀取該檔來產生 Excel 使用。

於網站根目錄建立 Excel 版型檔 template-employees.xlsx,並建立 Excel「標題列」與設定「篩選功能」:

程式範例

程式碼參考 /PHPExcel/Examples/:

  • 讀取 Excel:07reader.php。
  • 產生下載 Excel:01simple-download-xlsx.php。

於網站根目錄新增如下 PHP 程式後,於瀏覽器開啟即會自動下載 Excel 檔案:

download-employees.php:

<?php
error_reporting(E_ALL);
// ini_set('display_errors', TRUE);
ini_set('display_startup_errors', TRUE);

define('EOL',(PHP_SAPI == 'cli') ? PHP_EOL : '<br />');
date_default_timezone_set('Europe/London');

/*
 * Include PHPExcel_IOFactor
 */

require_once 'PHPExcel/Classes/PHPExcel/IOFactory.php';

// 自行建立的 Excel 版型檔名
$excelTemplate = 'template-employees.xlsx';

// 判斷 Excel 檔案是否存在
if (!file_exists($excelTemplate)) {
	exit('Please run template.php first.' . EOL);
}

// 載入 Excel
$objPHPExcel = PHPExcel_IOFactory::load($excelTemplate);

// 要寫入 Excel 的 Data
$data = [
            ['ID' => '1020501', 'Name' => '王小傑', 'Sex' => 'M', 'Department' => '資訊部'],
            ['ID' => '1030501', 'Name' => '陳小明', 'Sex' => 'M', 'Department' => '財務部'],
            ['ID' => '1040501', 'Name' => '李小黃', 'Sex' => 'F', 'Department' => '業務部']
        ];

// 將 Data 寫入 Excel
for ($i = 0, $len = count($data); $i < $len; $i++) {
    // 設定 Excel 第一個頁籤 (啟始值 0 為第 1 個),也就是 Sheet1
    $objPHPExcel->setActiveSheetIndex(0)
                    // setCellValue(欲設定 Excel 欄位, 值),Excel 欄位字母 A 為列、數值 1 為欄,由於 $i 啟始值為 0 且須跳過 Excel 第一列的標題,因此要加 2
                    ->setCellValue('A' . ($i + 2), $data[$i]['ID'])
                    ->setCellValue('B' . ($i + 2), $data[$i]['Name'])
                    ->setCellValue('C' . ($i + 2), $data[$i]['Sex'])
                    ->setCellValue('D' . ($i + 2), $data[$i]['Department']);
}

// 依欄位內容長度,自動設定寬度
// $objPHPExcel->getActiveSheet(0)->getColumnDimension('B')->setAutoSize(true);

// Redirect output to a client’s web browser (Excel2007)
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
// 設定下載 Excel 的檔案名稱
header('Content-Disposition: attachment;filename="員工資料.xlsx"');
header('Cache-Control: max-age=0');
// If you're serving to IE 9, then the following may be needed
header('Cache-Control: max-age=1');

// If you're serving to IE over SSL, then the following may be needed
header ('Expires: Mon, 26 Jul 1997 05:00:00 GMT'); // Date in the past
header ('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT'); // always modified
header ('Cache-Control: cache, must-revalidate'); // HTTP/1.1
header ('Pragma: public'); // HTTP/1.0

$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
$objWriter->save('php://output');
exit;

即可開啟有篩選功能的 Excel:

問題排除

在讀取、新增 Excel 2007 (含) 以上版本必須使用到 PHP 的 module (模塊) ZipArchive 來處理 ZIP 壓縮檔案,如未安裝則會出現下圖錯誤:

安裝 ZIP 模塊並重啟 Web server:

yum install -y php-pecl-zip
systemctl restart httpd

檢查是否有 ZIP 模塊,如下顯示 zip 即表示已安裝完成:

php -m | grep "zip"
zip

參考

發表迴響