当前位置：首页 > 文章列表 > 文章 > php教程 > PHP导出Excel技巧：PhpSpreadsheet使用教程

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

2026-03-25 21:15:36 0浏览收藏

本文深入解析了使用 PhpSpreadsheet 在 PHP 中高效、稳定导出 Excel 文件的核心技巧与实战要点：从替代已废弃 PHPExcel 的版本选型与兼容性（如 PHP 7.4 必须锁定 ^1.26 版本），到 Composer 标准化安装与命名空间避坑；重点强调导出失败的“罪魁祸首”——缺失响应头导致的乱码或空文件，并手把手拆解不可省略的四步核心流程（创建表格→获取工作表→写入数据→设置响应头后输出）；同时覆盖 CSV 转义、大数据量优化（禁用公式、分批写入、内存与超时调优）等高阶痛点，助你一次写出健壮、可上线的导出功能。

php怎么导出Excel_使用PhpSpreadsheet生成Excel文件【技巧】

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;