PhpSpreadsheet 是导出 Excel 最稳妥的纯 PHP 库,支持 .xlsx/.xls,需设中文字体防乱码,大数据量应流式写入避免内存溢出,CSV 无法替代 Excel 功能。

用 PhpSpreadsheet 导出 Excel 最稳妥
直接用原生 PHP 写 Excel 文件格式(如 .xlsx)几乎不可行,容易出错且不兼容。现在主流、维护活跃、支持 Excel 2007+(.xlsx)和旧版(.xls)的库是 PhpSpreadsheet(PHPExcel 的继任者)。它不依赖外部命令或 Excel 程序,纯 PHP 实现,部署简单。
安装方式(推荐 Composer):
composer require phpoffice/phpspreadsheet
导出一个最简表格的示例:
getActiveSheet();
$sheet->setCellValue('A1', '姓名');
$sheet->setCellValue('B1', '年龄');
$sheet->setCellValue('A2', '张三');
$sheet->setCellValue('B2', 28);
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');
?>
导出中文乱码?注意字符编码和字体设置
PhpSpreadsheet 默认使用 UTF-8,但 Excel 客户端(尤其 Windows 上的旧版 Excel)有时不自动识别,导致中文显示为方块或问号。这不是编码错误,而是缺少中文字体声明。
立即学习“PHP免费学习笔记(深入)”;
- 务必在写入中文前设置默认字体:
$spreadsheet->getDefaultStyle()->getFont()->setName('SimSun')(宋体)或'Microsoft YaHei'(微软雅黑) - 避免用
iconv或mb_convert_encoding对中文二次转码,PhpSpreadsheet内部已处理 UTF-8 - 如果用
header('Content-Type: ...')后仍乱码,检查 PHP 输出是否被 BOM 或空格截断(比如?> 之间有空行)
大数据量导出卡死或内存溢出?用 setCellValueExplicit + 流式写入
一次性把几万行数据载入内存再生成 Excel,PHP 很容易报 Fatal error: Allowed memory size exhausted。解决方案不是调大 memory_limit,而是改用「只写不读」的流式策略:
- 用
$spreadsheet->getActiveSheet()->setCellValueExplicit('A1', '内容', \PhpOffice\PhpSpreadsheet\Cell\DataType::TYPE_STRING)避免类型自动推断开销 - 逐行写入后立即用
$writer->save('php://output')输出(不能先save('file.xlsx')再读取) - 更彻底的做法:用
ChunkedDataWriter(需自行封装)或切换到轻量级方案spout(仅支持 .xlsx/.ods,不支持公式/样式,但内存恒定在 3MB 内)
为什么不用 fputcsv 导出 CSV 当 Excel?
CSV 看似简单,但实际埋坑不少:
- Excel 打开 UTF-8 编码 CSV 默认用 ANSI 解析,中文全乱;加 BOM(
\xEF\xBB\xBF)可缓解,但 Mac Excel 和 WPS 行为不一致 - 字段含逗号、换行、双引号时,必须严格按 RFC 4180 转义,手写易出错;
fputcsv虽能处理,但无法控制单元格样式、列宽、冻结窗格等 - 用户双击打开 CSV 时,Excel 可能启动「文本导入向导」,体验割裂;而 .xlsx 是明确的「工作表」语义
- 若业务要求「导出 Excel」且后续要插入图表或函数,CSV 根本不满足
除非导出量极大(100 万+ 行)、纯数据交付、且明确接受无格式限制,否则别用 CSV 冒充 Excel。











