17370845950

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() 写入数据（后者适合二维数组）
• 创建 Xlsx writer，并用 save('php://output') 输出到响应体
• 在 save() 前 设置完整响应头，且确保之前无任何输出（包括空行、BOM、echo）

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() 直接塞原始数据，应先遍历清洗
• Csv writer 不支持样式、多工作表，仅用于纯文本导出

$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() 释放中间变量。