PHP导出Excel技巧：PhpSpreadsheet使用教程

本文深入解析了使用 PhpSpreadsheet 在 PHP 中高效、稳定导出 Excel 文件的核心技巧与实战要点：从替代已废弃 PHPExcel 的版本选型与兼容性（如 PHP 7.4 必须锁定 ^1.26 版本），到 Composer 标准化安装与命名空间避坑；重点强调导出失败的“罪魁祸首”——缺失响应头导致的乱码或空文件，并手把手拆解不可省略的四步核心流程（创建表格→获取工作表→写入数据→设置响应头后输出）；同时覆盖 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 流。核心四步不能少：

• 创建 Spreadsheet 实例，用 getActiveSheet() 获取工作表
• 用 setCellValue() 或 fromArray() 写入数据（后者适合二维数组）
• 创建 Xlsx writer，并用 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() 直接塞原始数据，应先遍历清洗
• 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() 释放中间变量。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~