萬盛學電腦網

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

PHP 讀取 Excel 檔案完整指南:PHPExcel/PhpSpreadsheet 解析 .xls 與 .xlsx

前置準備

  • 舊專案:composer require phpoffice/phpexcel(已停止維護)。
  • 新專案:composer require phpoffice/phpspreadsheet(現代替代者,API 相似)。

核心讀取流程

require __DIR__ . '/vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;

$filePath = 'data.xlsx'; // 或 .xls

// 1. 自動偵測讀取器
$reader = IOFactory::createReaderForFile($filePath);
if (!$reader) {
    die('不支援的檔案格式');
}

// 2. 可選:只讀取資料,不載入格式/圖片,節省記憶體
$reader->setReadDataOnly(true);

// 3. 載入試算表
$spreadsheet = $reader->load($filePath);
$sheet = $spreadsheet->getActiveSheet(); // 或 getSheet(0)

// 4. 迭代列印
foreach ($sheet->getRowIterator() as $row) {
    $cellIterator = $row->getCellIterator();
    $cellIterator->setIterateOnlyExistingCells(false); // 含空儲存格
    $rowData = [];
    foreach ($cellIterator as $cell) {
        $rowData[] = $cell->getValue();
    }
    print_r($rowData);
}

// 釋放大型檔案記憶體
$spreadsheet->disconnectWorksheets();
unset($spreadsheet);

舊版 PHPExcel 寫法(參考)

require_once 'PHPExcel/IOFactory.php';

$reader = PHPExcel_IOFactory::createReaderForFile($filePath);
$objPHPExcel = $reader->load($filePath);
$sheet = $objPHPExcel->getSheet(0);

$highestRow    = $sheet->getHighestRow();
$highestColumn = $sheet->getHighestColumn();

for ($row = 1; $row <= $highestRow; $row++) {
    $rowData = [];
    for ($col = 'A'; $col <= $highestColumn; $col++) {
        $cell = $sheet->getCell($col . $row);
        $rowData[] = $cell->getValue();
    }
    $data[] = $rowData;
}

大檔案優化技巧

  1. ReadDataOnly:只讀數值,忽略樣式、圖表、公式計算。
  2. ChunkReadFilter:分塊讀取,每次只載入部分列到記憶體。
  3. 快取策略:$reader->setReadDataOnly(true); $spreadsheet->setCacheStorageMethod('sqlite3'); 將資料暫存 SQLite。

常見坑點

  • 日期儲存為 Excel 序列數,需用 PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject() 轉換。
  • 合併儲存格只在左上角有值,其餘為 null。
  • .xls 格式上限 65536 列,.xlsx 可達 1048576 列。
copyright © 萬盛學電腦網 all rights reserved