PHP处理Excel文件怎么读写数据-php教程-PHP中文网

用 phpspreadsheet 替代已停更且不兼容 php 8.2+ 的 phpexcel；读取需手动指定读取器（如'xlsx'），设 setreaddataonly(true)；中文乱码需设输入编码，日期用 date::isdatetime() 判断后转对象；大数据写入禁用样式、用 fromarray() 批量写，超5万行建议换 spout。

php处理excel文件怎么读写数据

直接上结论：用 PhpSpreadsheet，别碰 PHPExcel —— 它已停止维护，不兼容 PHP 8.2+，且在大文件、中文、日期处理上坑多雷密。

`IOFactory::load()` 读取失败？先看文件类型和扩展名是否匹配

IOFactory::load() 会根据文件扩展名自动选读取器，但容易翻车：

文件实际是 .xlsx，但后缀被改成 .xls → 报错 Could not auto-detect file type
上传时浏览器改了 MIME 类型（比如把 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet 改成 application/octet-stream）→ 读取器选错

解决办法是手动指定读取器：

use PhpOffice\PhpSpreadsheet\IOFactory;

$reader = IOFactory::createReader('Xlsx'); // 强制用 Xlsx 读取器
$reader->setReadDataOnly(true); // 只读值，跳过样式/公式（提速 + 避免乱码）
$spreadsheet = $reader->load($filePath);

支持的读取器名必须大写准确：'Xlsx'、'Xls'、'Csv'、'Ods'。小写或拼错会抛出 InvalidArgumentException。

读取时中文乱码、日期变数字？关键在单元格值获取方式

$cell->getValue() 返回原始存储值，对中文、日期不友好：

中文字段可能返回空或乱码（尤其从 Windows Excel 保存的 ANSI 编码 CSV）
日期显示为类似 44562 的序列号（Excel 序列日期）

正确做法：

Excel Export

从结构化JSON生成精美的.xlsx工作簿，支持多工作表、冻结表头、筛选、类型化列、公式、合计以及法国/摩洛哥格式。

下载

中文乱码：读 CSV 时显式设置编码（$reader->setInputEncoding('GBK') 或 'UTF-8'），xlsx 一般无此问题
日期识别：先用 \PhpOffice\PhpSpreadsheet\Shared\Date::isDateTime($cell) 判断，再用 $cell->getCalculatedValue() 或 Date::excelToDateTimeObject() 转时间对象

if (\PhpOffice\PhpSpreadsheet\Shared\Date::isDateTime($cell)) {
    $dateObj = \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($cell->getValue());
    $value = $dateObj->format('Y-m-d H:i:s');
} else {
    $value = $cell->getCalculatedValue(); // 公式也走这里
}

注意：getCalculatedValue() 比 getValue() 稍慢，但能统一处理公式、日期、数值格式。

写入大数据量 Excel 时内存爆掉？关掉样式 + 开流式写入

Spreadsheet 默认把整张表对象全加载进内存。10 万行 × 20 列就可能吃掉 500MB+ 内存。

必须做两件事：

创建时禁用样式缓存：$spreadsheet->getProperties()->setCreator('')->setTitle('')->setDescription('');（减少元数据开销）
写入用 fromArray() 批量塞，别用 setCellValue() 循环单写（性能差 3–5 倍）
超过 5 万行，考虑换 Spout：它不建对象模型，纯流式，内存恒定在 ~3MB

示例（安全写入）：

$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

// 一次性写入二维数组（比循环快得多）
$header = ['姓名', '邮箱', '注册时间'];
$data = [
    ['张三', 'zhang@example.com', '2026-09-27'],
    ['李四', 'li@example.com', '2026-09-26'],
];
$sheet->fromArray(array_merge([$header], $data), null, 'A1');

$writer = IOFactory::createWriter($spreadsheet, 'Xlsx');
$writer->save('/tmp/export.xlsx');

复杂点在于：不同来源的 Excel 行为不一致 —— 用户上传的文件可能混用 .xlsx/.xls/.csv，还带合并单元格、隐藏列、自定义格式。别指望一个 load() 调用通吃所有情况。真正上线前，必须拿真实用户上传样本跑几轮，重点测空单元格、跨行合并、超长文本截断、特殊字符（如换行符 \n）是否被转义。这些细节不提前踩，上线后就是半夜告警。