替代停止维护的box/spout：PHP Excel导出库选型咨询

一、替代box/spout的高效Excel导出方案 #

针对你需要轻量、快速、无复杂格式的Excel导出需求，推荐以下两个方案：

• FastExcel：基于PhpSpreadsheet的轻量封装库，专门优化了大量数据的导出效率，API简洁易用，完全适配你的场景。直接通过Composer安装：composer require rap2hpoutre/fast-excel。在Symfony中可直接结合Doctrine查询结果快速生成XLSX文件，无需额外处理复杂配置。
• PhpSpreadsheet原生流式导出：如果不想依赖第三方封装，直接使用PhpSpreadsheet的流式写入模式，这是目前解决大量数据导出性能问题的核心方案，下文会详细说明。

二、PhpSpreadsheet大量行导出的性能解决方案 #

PhpSpreadsheet已经通过流式写入解决了旧版本的内存溢出问题，针对XLSX格式支持完善，不会一次性加载所有数据到内存。结合Alpine容器环境，实践要点如下：

1. 启用流式写入与磁盘缓存
   代码示例：

   use PhpOffice\PhpSpreadsheet\Spreadsheet;
   use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
   
   $spreadsheet = new Spreadsheet();
   $worksheet = $spreadsheet->getActiveSheet();
   
   // 初始化流式写入配置
   $writer = new Xlsx($spreadsheet);
   $writer->setPreCalculateFormulas(false); // 关闭公式预计算，提升速度
   $writer->setUseDiskCaching(true, sys_get_temp_dir()); // 用磁盘缓存替代内存缓存
   
   // 分批读取数据库数据并写入
   $batchSize = 1000;
   $offset = 0;
   $entityManager = $this->getDoctrine()->getManager();
   while ($rows = $entityManager->getRepository(YourEntity::class)->findBy([], null, $batchSize, $offset)) {
       foreach ($rows as $rowIndex => $row) {
           $lineNum = $offset + $rowIndex + 1;
           $worksheet->setCellValue('A' . $lineNum, $row->getField1());
           $worksheet->setCellValue('B' . $lineNum, $row->getField2());
           // 写入其他字段...
       }
       $offset += $batchSize;
       $entityManager->clear(); // 释放当前批次实体，减少内存占用
   }
   
   $writer->save('export.xlsx');
   

2. Alpine环境依赖配置
   确保安装PHP必需扩展：apk add php81-zip php81-xml，XLSX格式依赖zip扩展，PhpSpreadsheet核心功能依赖xml扩展。同时保证临时目录（sys_get_temp_dir()）有读写权限。

三、2022年Excel导出实践经验 #

• 流式导出是核心：只要数据量超过1万行，必须采用流式/分批写入模式，这也是box/spout当年高效的核心原因，替代方案必须保持这个特性。
• 拒绝冗余格式操作：如果用户仅需纯数据，不要设置单元格样式、合并单元格、公式等，这类操作会大幅降低导出速度并增加内存消耗。
• 数据库查询优化：导出大量数据时，必须分页查询（Doctrine用findBy的offset/limit，或原生SQL分批读取），避免一次性拉取全量数据导致内存溢出。
• 容器环境调优：合理设置PHP内存限制（如ini_set('memory_limit', '256M')），无需过大但要适配批次大小；定期清理临时文件，避免磁盘空间占用过高。
• 边界测试：针对业务场景测试10万、50万行等数据量的导出情况，调整批次大小（1000-5000行/批为最优区间），平衡数据库查询次数与内存占用。

内容的提问来源于stack exchange，提问作者Calamity Jane