您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 使用 PHPExcel 實現 Excel 數據導入導出完整指南

編輯：PHP 相關知識

PHPExcel 導入導出數據實戰教程

PHPExcel 是 PHP 操作 Excel 文件的經典庫，雖然已停止維護（建議遷移至 PhpSpreadsheet），但在許多舊專案中仍廣泛使用。本文將詳細講解如何使用 PHPExcel 實現 Excel 數據的導入與導出，並提供可直接應用的代碼範例。

一、環境準備與基礎配置

在開始之前，請確保已下載 PHPExcel 庫並正確配置引入路徑。典型的初始化代碼如下：

<?php
error_reporting(E_ALL);
set_time_limit(0);
date_default_timezone_set('Europe/London');

// 設定 PHPExcel 類庫路徑
set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/Classes/');
include 'PHPExcel/IOFactory.php';
?>

二、Excel 數據導入（讀取）

以下範例示範如何讀取 .xlsx 文件，遍歷工作表並提取數據：

<?php
$inputFileType = 'Excel2007'; // 讀取 xlsx 格式
$inputFileName = './sampleData/book.xlsx';

echo 'Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory...<br />';

$objReader = PHPExcel_IOFactory::createReader($inputFileType);
$objPHPExcel = $objReader->load($inputFileName);

$objWorksheet = $objPHPExcel->getActiveSheet();
$highestRow = $objWorksheet->getHighestRow();
$highestColumn = $objWorksheet->getHighestColumn();
$highestColumnIndex = PHPExcel_Cell::columnIndexFromString($highestColumn);

echo '總行數: ' . $highestRow . '<br />';
echo '總列數: ' . $highestColumnIndex . '<br />';

$headtitle = [];
for ($row = 1; $row <= $highestRow; $row++) {
    $strs = [];
    for ($col = 0; $col < $highestColumnIndex; $col++) {
        $strs[$col] = $objWorksheet->getCellByColumnAndRow($col, $row)->getValue();
    }
    $info = [
        'word1' => $strs[0],
        'word2' => $strs[1],
        'word3' => $strs[2],
        'word4' => $strs[3],
    ];
    // 此處可連接資料庫寫入數據
    print_r($info);
    echo '<br />';
}
?>

三、Excel 數據導出（寫入）

導出功能支援自定義標題、樣式設置、瀏覽器直接下載。以下是兩種常見實現方式：

方式一：完整導出類方法

<?php
private function _export_data($data = array()) {
    error_reporting(E_ALL);
    set_time_limit(0);
    date_default_timezone_set('Europe/London');
    
    set_include_path(FCPATH . APPPATH . '/libraries/Classes/');
    include 'PHPExcel.php';
    
    $objPHPExcel = new PHPExcel();
    
    // 設置文檔屬性
    $objPHPExcel->getProperties()
        ->setCreator("Maarten Balliauw")
        ->setLastModifiedBy("Maarten Balliauw")
        ->setTitle("Office 2007 XLSX Test Document")
        ->setSubject("Office 2007 XLSX Test Document")
        ->setDescription("Test document for Office 2007 XLSX, generated using PHP classes.")
        ->setKeywords("office 2007 openxml php")
        ->setCategory("Test result file");
    
    $letter = range('A', 'Z');
    
    if ($data) {
        $i = 1;
        foreach ($data as $key => $value) {
            $objPHPExcel->setActiveSheetIndex(0);
            $j = 0;
            foreach ($value as $k => $val) {
                // 處理特殊字符，防止公式注入
                $val = str_replace('=', '', $val);
                $index = $letter[$j] . $i;
                $objPHPExcel->getActiveSheet()->setCellValue($index, $val);
                $j++;
            }
            $i++;
        }
    }
    
    $date = date('Y-m-d', time());
    $objPHPExcel->getActiveSheet()->setTitle($date);
    $objPHPExcel->setActiveSheetIndex(0);
    
    // 輸出到瀏覽器
    header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    header('Content-Disposition: attachment;filename="' . $date . '.xlsx"');
    header('Cache-Control: max-age=0');
    
    $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
    $objWriter->save('php://output');
    exit;
}
?>

方式二：簡易導出函數（支援 .xls 格式）

<?php
public function export_data($data = array()) {
    include_once(APP_PATH . 'Tools/PHPExcel/Classes/PHPExcel/Writer/IWriter.php');
    include_once(APP_PATH . 'Tools/PHPExcel/Classes/PHPExcel/Writer/Excel5.php');
    include_once(APP_PATH . 'Tools/PHPExcel/Classes/PHPExcel.php');
    include_once(APP_PATH . 'Tools/PHPExcel/Classes/PHPExcel/IOFactory.php');
    
    $obj_phpexcel = new PHPExcel();
    $obj_phpexcel->getActiveSheet()->setCellValue('A1', 'Key');
    $obj_phpexcel->getActiveSheet()->setCellValue('B1', 'Value');
    
    if ($data) {
        $i = 2;
        foreach ($data as $key => $value) {
            $obj_phpexcel->getActiveSheet()->setCellValue('A' . $i, $value);
            $i++;
        }
    }
    
    $obj_Writer = PHPExcel_IOFactory::createWriter($obj_phpexcel, 'Excel5');
    $filename = "outexcel.xls";
    
    header("Content-Type: application/force-download");
    header("Content-Type: application/octet-stream");
    header("Content-Type: application/download");
    header('Content-Disposition: inline; filename="' . $filename . '"');
    header("Content-Transfer-Encoding: binary");
    header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
    header("Pragma: no-cache");
    
    $obj_Writer->save('php://output');
}
?>

四、常見問題與最佳實踐

記憶體優化：大數據量導出時，建議使用 PHPExcel_CachedObjectStorageFactory 啟用緩存機制，或分批寫入。
公式注入防護：導出用戶輸入數據時，務必過濾開頭為 =、+、-、@ 的字符串。
版本遷移：新專案強烈建議使用 PhpSpreadsheet，API 相似但效能更好、持續維護。
日期格式處理：讀取 Excel 日期儲存為數值，需使用 PHPExcel_Shared_Date::ExcelToPHP() 轉換為 PHP 時間戳。