php代码示例怎样导出excel表格_php导出excel代码示例【示例】

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

PhpSpreadsheet 导出 Excel 最稳妥

直接用原生 PHP 写 Excel 文件格式(如 .xlsx)几乎不可行,容易出错且不兼容。现在主流、维护活跃、支持 Excel 2007+(.xlsx)和旧版(.xls)的库是 PhpSpreadsheetPHPExcel 的继任者)。它不依赖外部命令或 Excel 程序,纯 PHP 实现,部署简单。

安装方式(推荐 Composer):

composer require phpoffice/phpspreadsheet

导出一个最简表格的示例:

getActiveSheet();
$sheet->setCellValue('A1', '姓名');
$sheet->setCellValue('B1', '年龄');
$sheet->s

etCellValue('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)有时不自动识别,导致中文显示为方块或问号。这不是编码错误,而是缺少中文字体声明。

  • 务必在写入中文前设置默认字体:$spreadsheet->getDefaultStyle()->getFont()->setName('SimSun')(宋体)或 'Microsoft YaHei'(微软雅黑)
  • 避免用 iconvmb_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。