怎样解析和生成复杂的Excel文件？用Composer安装PhpSpreadsheet-composer-PHP中文网

安装失败主因是php版本＜7.4或xml/zip/mbstring扩展缺失；读大excel需设只读+行迭代；写入性能差应禁用预计算并用fromarray批量写；读.xls报错须手动注册xls reader。

怎样解析和生成复杂的excel文件？用composer安装phpspreadsheet

安装失败？先确认 PHP 版本和扩展是否就位

直接运行 composer require phpoffice/phpspreadsheet 报错，大概率不是命令问题，而是环境卡点。PHP 必须 ≥ 7.4（2026 年主流稳定版已要求 ≥ 8.0），且三个扩展缺一不可：xml、zip、mbstring。用 php -m | grep -E "xml|zip|mbstring" 检查；若缺失，Linux 上跑 sudo apt install php-xml php-zip php-mbstring，Windows 则打开 php.ini 取消对应 extension= 行前的分号，再重启服务。

国内用户常卡在下载超时，临时切阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。装完别急着写代码，先建个 test.php 验证：

<?php require __DIR__ . '/vendor/autoload.php';
$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
echo "OK\n";
?>

执行 php test.php 输出 OK 才算真正可用。否则大概率是 autoload.php 路径错了，或 CLI 和 Web 服务器用了不同 php.ini（用 php --ini 查）。

读大 Excel 文件内存爆掉？必须开只读 + 行迭代

上传一个 10MB 的 .xlsx，默认 IOFactory::load() 可能吃掉 300MB+ 内存，直接 OOM。关键不是“能不能读”，而是“怎么读不崩”：

$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader('Xlsx') —— 显式指定格式，别依赖后缀自动判断
$reader->setReadDataOnly(true) —— 跳过样式、公式、合并单元格等元数据
$reader->setLoadAllSheets(false) —— 只加载目标工作表，避免全表解析
用 getRowIterator() 替代 getActiveSheet()->toArray()，逐行拉取而非一次性载入全部

错误示范：$spreadsheet = IOFactory::load($_FILES['file']['tmp_name']) —— 临时文件可能已被清理。正确做法是先 move_uploaded_file() 到安全目录，再传绝对路径给 load()。

excel-clean

Excel 数据清洗——去重、填补缺失值、格式转换。

下载

写复杂表格性能差？禁用预计算 + 改用批量写入

循环调用 setCellValue('A'.$i, $value) 写 5 万行，不仅慢，还会触发大量中间状态重建（样式缓存、行列索引更新）。实际瓶颈不在 I/O，而在对象内部开销：

写入前关掉公式预计算：$writer->setPreCalculateFormulas(false)
用 fromArray() 代替逐单元格赋值：$sheet->fromArray($data, null, 'A1')，二维数组一次塞进整块区域
如果数据量极大（如导出日志），需手动分片：每 5000 行新建一个 Spreadsheet 实例，save() 后销毁，避免单实例长期持有多内存

注意：fromArray() 第二个参数是空值占位符，设为 null 表示跳过空单元格；第三个参数是起始坐标，别写成 'A0' 或漏掉引号。

为什么读 .xls 总报错？格式和 Reader 必须严格匹配

IOFactory::load() 不解析文件头，只看扩展名。你传 data.xls，它就去找 Xls Reader；但新版本默认不注册 Xls，所以会抛 InvalidArgumentException: No reader found for extension ".xls"。

解决方法只有两个：

转格式：让用户上传 .xlsx，或服务端用 LibreOffice 命令行转一次（libreoffice --headless --convert-to xlsx file.xls）
手动注册 Reader：\PhpOffice\PhpSpreadsheet\IOFactory::registerReader('Xls', \PhpOffice\PhpSpreadsheet\Reader\Xls::class)，再调用 load()

这个点极容易被忽略——调试时本地测试用的是 .xlsx，上线后用户上传 .xls，立刻崩，而错误信息完全没提示“你少注册 Reader”。