如何使用PHP生成Excel报表-php教程-PHP中文网

必须用 phpspreadsheet 生成真实 excel 文件，因 fputcsv 和旧 mime 类型仅输出 csv 文本，不支持样式、公式、多表等，且易乱码或报错；安装后用 fromarray 批量写入、设中文字体、清缓冲、配正确响应头，并注意内存优化与编码统一。

如何使用php生成excel报表

PHP 本身不带 Excel 生成功能，直接用 fputcsv 只能生成 CSV（不是真正的 Excel 文件），真要生成 .xlsx 或 .xls，必须依赖第三方库——其中 phpspreadsheet 是当前唯一活跃、兼容 PHP 7.4+ 且支持 Office Open XML 标准的主流选择。

为什么不能只用 `fputcsv` 或 `header("Content-Type: application/vnd.ms-excel")`

这些方式输出的是 CSV 文本，用 Excel 打开虽能显示，但本质是纯文本：不支持单元格样式、公式、合并、图片、多工作表，且中文常乱码；更严重的是，Excel 2007+ 默认禁用“来自 Web 的 CSV 自动格式识别”，用户打开时可能弹出安全警告或格式错乱。如果你的报表要发给财务、审计或需要打印签字，这类“伪 Excel”基本不可用。

fputcsv 输出的文件后缀写成 .xlsx 也没用——文件头和结构完全不符，Excel 会拒绝打开或报“文件已损坏”
application/vnd.ms-excel 是旧版 Excel 97–2003 的 MIME 类型，对 .xlsx 无效；现代浏览器也早已弱化对该类型的处理
若强行用 COM 扩展（Windows + Excel 安装）调用本地 Excel 进程，部署在 Linux 服务器上直接失败，且并发高时极易卡死

用 `phpspreadsheet` 生成真实 .xlsx 的最小可行步骤

先通过 Composer 安装：composer require phpoffice/phpspreadsheet。注意：不要装错成已归档的 PHPExcel（2015 年停止维护）。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

加载类：require 'vendor/autoload.php';，然后 $spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
写数据不用循环 setCellValue 拼接——对大批量数据极慢；改用 fromArray 一次性导入二维数组：$spreadsheet->getActiveSheet()->fromArray($data, null, 'A1');
设置中文标题行样式（避免默认字体不支持中文）：$spreadsheet->getActiveSheet()->getStyle('A1:Z1')->getFont()->setName('SimSun'); // Windows 或 'Noto Sans CJK SC'（Linux/macOS）
导出前必须清除输出缓冲：ob_end_clean();，否则空格或 BOM 会导致 Excel 报“文件已损坏”
输出响应头要严格匹配：header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); 和 Content-Disposition: attachment;filename="report.xlsx"

常见报错及绕过方法

最典型的是 Call to a member function getStyle() on null，通常因操作了不存在的工作表（比如删了默认 Sheet1 后没用 createSheet() 新建）；或 Memory limit exhausted —— 处理 10 万行以上数据时，phpspreadsheet 默认把整张表载入内存。

解决内存问题：用 setPreCalculateFormulas(false) 关闭公式预计算；对超大报表，改用 Writer\Xlsx\Writer 的流式写入模式（需手动构造 XML 片段，官方文档叫 “Cell caching” + setCacheType 为 cache_to_php_temp）
中文乱码：确保 PHP 文件本身是 UTF-8 无 BOM 编码；fromArray 的数据源数组值必须是 UTF-8 字符串，不要用 iconv 或 mb_convert_encoding 二次转码
日期变成数字：Excel 内部用浮点数存日期，PHP 数组里传 date('Y-m-d') 字符串即可；若传 time() 时间戳，需用 PhpOffice\PhpSpreadsheet\Shared\Date::PHPToExcel 转换
合并单元格后内容不居中：合并只是视觉操作，内容仍锚定在左上角单元格，需额外调用 getAlignment()->setHorizontal(...)