phpspreadsheet 是当前 php 导出 excel 最可靠的选择，替代已废弃的 phpexcel；支持 .xlsx、.xls、.csv 等格式但默认仅生成 .xlsx，需手动设置响应头否则浏览器乱码或下载为空；必须用 composer 安装，v2.0+ 要求 php ≥ 8.0，php 7.4 需锁定 ^1.26 版本；导出核心四步：创建 spreadsheet、获取工作表、写入数据、设置响应头后 save('php://output')；csv 导出需手动转义特殊字符；大数据量导出需禁用公式计算、分批写入并调优内存与超时配置。
PhpSpreadsheet 是当前 PHP 导出 Excel 最可靠的选择，替代已废弃的 PHPExcel；它支持 .xlsx、.xls、.csv 等格式，但默认只生成 .xlsx，且不直接输出 Excel 二进制流——必须手动设置响应头，否则浏览器会乱码或下载为空文件。
安装 PhpSpreadsheet 并确认最低 PHP 版本
用 Composer 安装是唯一推荐方式，避免手动引入类文件导致的自动加载失败：
composer require phpoffice/phpspreadsheet
注意：phpspreadsheet v2.0+ 要求 PHP ≥ 8.0；若项目仍在用 PHP 7.4，必须锁定版本：
composer require phpoffice/phpspreadsheet:^1.26
- PHP 7.4 只能用
^1.26，更高版本会报ParseError: syntax error, unexpected token "string" - Composer 安装后无需
require或include，Autoloader 自动加载所有类 - 不要混用
PHPExcel和PhpSpreadsheet的命名空间，否则类找不到
写入数据并正确触发浏览器下载
导出失败最常见原因是没设置响应头，或调用 ob_end_clean() 不及时，导致额外空格/HTML 混入 Excel 流。核心四步不能少：
立即学习“PHP免费学习笔记（深入）”；
- 创建
Spreadsheet实例，用getActiveSheet()获取工作表 - 用
setCellValue()或fromArray()写入数据（后者适合二维数组） - 创建
Xlsxwriter，并用save('php://output')输出到响应体 -
在
save()前 设置完整响应头，且确保之前无任何输出（包括空行、BOM、echo）
<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->fromArray([
['姓名', '年龄', '城市'],
['张三', 28, '北京'],
['李四', 32, '上海'],
]);
// ⚠️ 必须在 save() 前执行，且不能有任何前置输出
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="users.xlsx"');
header('Cache-Control: max-age=0');
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;
?>
导出 CSV 时字段含逗号、换行或引号的处理
直接用 setCellValue() 写 CSV 容易破坏格式，因为 PhpSpreadsheet 的 Csv writer 本身不自动包裹字段（如 "abc,def"）。必须手动预处理数据：
- 对每个单元格值调用
fputcsv()风格转义：含,、"或换行符的字段，需用双引号包裹，且内部双引号要变成两个（"→""） - 不要用
fromArray()直接塞原始数据，应先遍历清洗 -
Csvwriter 不支持样式、多工作表，仅用于纯文本导出
$data = [
['name' => '王"五', 'desc' => "喜欢编程,\n也爱跑步"],
['name' => '赵六', 'desc' => '普通用户']
];
$cleaned = [];
foreach ($data as $row) {
$cleaned[] = array_map(function($v) {
// 简单 CSV 转义：含特殊字符就加引号，内部引号翻倍
if (preg_match('/[",\n\r]/', $v)) {
return '"' . str_replace('"', '""', $v) . '"';
}
return $v;
}, $row);
}
$spreadsheet = new Spreadsheet();
$spreadsheet->getActiveSheet()->fromArray($cleaned);
$writer = new \PhpOffice\PhpSpreadsheet\Writer\Csv($spreadsheet);
$writer->setUseBOM(true); // 防止中文在 Excel 中乱码
header('Content-Type: text/csv;charset=UTF-8');
header('Content-Disposition: attachment;filename="data.csv"');
$writer->save('php://output');
exit;
内存不足或超时导致导出失败怎么办
导出万级行数据时，默认配置容易触发 Fatal error: Allowed memory size exhausted 或 Maximum execution time exceeded。关键调整点：
- 禁用公式预计算：
$spreadsheet->setCalculateFormulae(false) - 关闭单元格缓存（改用
ISheet+setCellValueExplicit()） - 用
chunk分批写入，避免一次性构造整个二维数组 - 增加脚本限制：
ini_set('memory_limit', '512M')、set_time_limit(300)（仅限 CLI 或可信环境）
真正省内存的做法是：不用 fromArray()，而用循环 + setCellValueByColumnAndRow()，并配合 garbage_collect() 释放中间变量。
