1. 库选型与生态对比
在PHP 操作 Excel的场景中，主流的实现路径有多种库与工具。PhpSpreadsheet、PHPExcel（已弃用）、以及面向大数据量的Box/Spout等各有优势与限制。本节旨在帮助你理解不同生态的定位，并且明确在实际开发中应如何取舍，本文也围绕从简单导出到复杂表格处理的实战指南展开。继续阅读可以快速掌握在中小型项目与大数据场景下的不同权衡要点。
PhpSpreadsheet是当前最活跃的主流库，拥有完整的文档、丰富的样式设置和对复杂表格的良好支持；它的生态完善，适合企业级应用的持续迭代。相对而言，PHPExcel作为老旧版本，已停止维护，迁移到PhpSpreadsheet能获得更好的性能与未来兼容性。对于海量数据导出，Box/Spout提供了对流式写入的优秀支持，能显著降低内存占用。以上三者的对比，核心在于需求的规模与复杂度。
性能与授权是另一个重要维度。PhpSpreadsheet使用较多文档，MIT/OSI 等友好授权，便于团队合规开发；Box/Spout以开源许可证著称，适合需要高吞吐的场景。对于商业化项目，结合实际需求评估，才是最好的选择。与此同时，跨框架的整合能力也是一个考量点，如在Laravel生态中，Laravel-Excel（基于PhpSpreadsheet）可以提升开发效率。
1.1 常用库概览
在日常开发中，PhpSpreadsheet通常是默认首选，因为它提供了完整的写入、读取、样式和公式支持，且文档齐全。Box/Spout则在需要处理大数据量且内存敏感的场景更具优势，尤其是在导出海量行数据时能显著降低峰值内存。对于极端大数据场景，可以考虑将数据分批写入或采用流式写出方案来避免一次性加载全部数据。
在迁移与兼容性方面，从PHPExcel迁移到PhpSpreadsheet是常见需求，官方提供了迁移路径与命名空间调整的说明。通过合适的适配层，可以尽量降低改动成本，并保持现有业务逻辑。以下小结强调的是选择库时的关键指标：社群活跃度、文档完善度、以及<对复杂表格（合并单元格、样式、公式等）的原生支持情况。
1.2 适用场景对比
中等规模表格、需要单元格样式和公式计算的场景，推荐优先考虑PhpSpreadsheet，因为它提供了全面的样式API和公式解析能力，能更好地贴近办公表格的需求。对于需要高吞吐、无论数据量多大都能稳定输出的场景，Box/Spout提供了更好的流式写入能力。若仅导出简单数据且对格式要求不高，CSV导出也是一个轻量级且高效的选项，可以在不牵扯Excel格式的情况下实现快速导出。
兼容性与后续维护方面，优先选用PhpSpreadsheet的原因在于其长期维护与社区活跃性；而对于需要在现有PHPProjeto中快速替换的场景，可以先评估
2. 简单导出：从数据到 Excel 文件
2.1 使用 PhpSpreadsheet 做导出
简单导出是最常见的入门场景，PhpSpreadsheet可以很容易地把数据写入单个工作表并导出为 xlsx 文件。核心步骤是创建一个工作表、填充单元格、再通过写出器输出文件。此处的示例演示了最基础的导出流程，适合快速上线的短期任务。
getActiveSheet();$sheet->setCellValue('A1', '姓名');
$sheet->setCellValue('B1', '分数');
$sheet->setCellValue('A2', '张三');
$sheet->setCellValue('B2', 92);$writer = new Xlsx($spreadsheet);
$writer->save('report.xlsx');
?>在上面的简单导出示例中，核心要点包括：数据写入、工作表定位、以及输出目标文件。如果需要通过浏览器直接下载，可以将写出器改为输出流模式，并设置适当的 Content-Type 与 Content-Disposition。这样可以实现无缓存的即时下载。
导出格式的选择也很重要。XLSX适合含有格式与公式的工作表，CSV是跨平台兼容性极高、文件体积更小的选项，且在处理大数据时通常更高效。根据目标系统的读取能力选择合适的格式，可以提升用户体验。
2.2 快速导出到 CSV
如果目标仅是记录数据且对格式要求不高，CSV是一种极其高效的导出方式。fputcsv可以实现逐行写入，内存占用低，非常适合日志数据或大数据统计的月度导出。
在这个CSV导出示例中，逐行写入避免了一次性将所有数据加载到内存，从而提升了稳定性与扩展性。若数据来源于数据库，可以采用分块查询与分块写入的组合策略，以确保在百万级数据时仍然高效。
3. 复杂表格处理：合并单元格、公式、样式
3.1 复杂表格的样式与合并
面对需要复杂排版的表格，合并单元格、字体样式、边框与填充的应用变得尤为重要。PhpSpreadsheet的样式API支持对区域进行合并、设置对齐方式、应用填充颜色与边框样式，以及对单元格的字体进行加粗、斜体等处理。这些能力是实现专业办公级报表的基础。
合并单元格可以用来实现标题跨多列的效果，并且可以结合居中对齐来提升可读性。对单元格区域应用样式时，建议先定义一个统一的样式对象再应用到区域，以便后续维护。
样式与格式化在生成最终报表时尤为重要，因为不同客户端对 Excel 的渲染略有差异，确保样式在不同版本的 Excel 客户端中的一致性，是一个常见挑战。
mergeCells('A1:C1');
$sheet->setCellValue('A1', '年度销售报表');
$styleArray = ['font' => ['bold' => true, 'size' => 12],'alignment' => ['horizontal' => \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER],'borders' => ['allBorders' => ['borderStyle' => \PhpOffice\PhpSpreadsheet\Style\Border::BORDER_THIN]],'fill' => ['fillType' => \PhpOffice\PhpSpreadsheet\Style\Fill::FILL_SOLID,'startColor' => ['rgb' => 'FFFFCC']]
];
$sheet->getStyle('A1:C1')->applyFromArray($styleArray);
?> 以上示例展示了合并单元格与统一样式的组合用法，适用于标题行、分组小计行等场景。通过合理分区与样式，能显著提升报表的专业度与可读性。
3.2 公式与数据验证
在复杂表格中，公式计算与数据有效性是核心功能。PhpSpreadsheet提供对公式的写入与解析能力，能将单元格公式保留在导出文件中，便于下游在 Excel 中自动计算。数据验证则可通过设置下拉选项、数值范围等来提升数据质量。
公式写入通常通过在目标单元格设置等价的公式字符串实现，例如在B2写入一个基于A列和C列的公式。务必注意在不同版本的 Excel 中，公式的区域引用与语言区域可能存在差异，需要进行测试。
setCellValue('B2', '=A2+C2');
/* 复杂公式的写入要点：确保区域引用正确、不要滥用 volatile 函数，避免性能骤增。 */
?> 4. 大数据量处理与性能优化
4.1 流式写入与分块
当导出数据规模达到数十万行甚至上百万行时，内存占用成为瓶颈。此时，流式写入或<分块写入成为必要策略。Box/Spout提供了原生的流式写入能力，能够在写入期间仅保持有限的内存占用。
在使用<Box/Spout进行大数据导出时，可以先准备数据分块，然后逐块写入到目标文件中，避免一次性将全部数据加载到内存。这样做的好处是可以显著降低峰值内存、提升稳定性，并且利于并发处理。
openToFile('large.xlsx');
$header = WriterEntityFactory::createRowFromArray(['序号','名称','数量']);
$writer->addRow($header);foreach ($dataChunk as $row) {$writer->addRow(WriterEntityFactory::createRowFromArray($row));
}
$writer->close();
?> 通过上面的流式写入示例，尽管数据量很大，也能保持较低的内存占用。对于读取海量数据时，可以使用只读取数据的选项来加速加载并降低内存消耗。
4.2 分批读写与内存管理
除了输出，读取阶段的内存管理同样重要。通过ReadOnly或分块读取，可以在处理大文件时避免占用过多内存。对于需要逐行处理的场景（如生成报告、数据清洗等），逐行读取是常用策略。
setReadDataOnly(true);
$spreadsheet = $reader->load('big.xlsx');
foreach ($spreadsheet->getActiveSheet()->getRowIterator() as $row) {// 逐行处理
}
?> 5. 迁移与兼容性策略
5.1 从 PHPExcel 迁移到 PhpSpreadsheet
历史项目中常见的需求是在不中断现有业务的情况下完成迁移。PHPExcel已停止维护，推荐采取PhpSpreadsheet作为长期解决方案。迁移要点包括命名空间调整、加载方式变更以及写入器对象的改动。下面的要点可帮助你快速落地：更新命名空间、替换类名与方法、以及逐步替换测试。
命名空间调整通常涉及将 PHPExcel 的引用改为 PhpOffice\PhpSpreadsheet 命名空间，例如 PHPExcel\IOFactory 替换为 PhpOffice\PhpSpreadsheet\IOFactory。对于现有的工作流，建议先在开发分支完成迁移，再进行回归测试。
5.2 自动化迁移工具与兼容性注意事项
为了减少风险，可以在迁移中引入自动化检测与转换工具，辅助将代码中的类名、命名空间和常用方法映射到新版本。迁移时应关注以下兼容性要点：公式引用、单元格区域、以及样式定义在新版本中的表现是否保持一致。
此外，在公司级应用中，建议建立一个回滚机制和阶段性发布的策略，以确保新版本在生产环境中的可控性与可观测性。
