前置準備
- 舊專案:
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;
}
大檔案優化技巧
- ReadDataOnly:只讀數值,忽略樣式、圖表、公式計算。
- ChunkReadFilter:分塊讀取,每次只載入部分列到記憶體。
- 快取策略:
$reader->setReadDataOnly(true); $spreadsheet->setCacheStorageMethod('sqlite3'); 將資料暫存 SQLite。
常見坑點
- 日期儲存為 Excel 序列數,需用
PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject() 轉換。
- 合併儲存格只在左上角有值,其餘為 null。
- .xls 格式上限 65536 列,.xlsx 可達 1048576 列。