PhpSpreadsheet 是当前 PHP 导出 Excel 最可靠的选择，替代已废弃的 PHPExcel；支持 .xlsx、.xls、.csv 等格式但默认仅生成 .xlsx，需手动设置响应头否则浏览器乱码或下载为空；必须用 Composer 安装，v2.0+ 要求 PHP ≥ 8.0，PHP 7.4 需锁定 ^1.26 版本；导出核心四步：创建 Spreadsheet、获取工作表、写入数据、设置响应头后 save('php://output')；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）

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() 释放中间变量。

# php  # excel  # html  # composer  # 大数据  # 浏览器  # app  # office  # csv  # 上海  # echo  # String  # 命名空间  # include  # require  # Error  # Token  # 循环  # bom  # 会报  # 为空  # 单元格  # 最可靠  # 特殊字符  # 双引号  # 自动加载  # 找不到  # 遍历  # 翻倍 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： canvas 画布在主流浏览器中的尺寸限制详细介绍  香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧  香港服务器网站推广：SEO优化与外贸独立站搭建策略  Laravel用户认证怎么做_Laravel Breeze脚手架快速实现登录注册功能  魔毅自助建站系统：模板定制与SEO优化一键生成指南  Laravel如何实现用户注册和登录？（Auth脚手架指南）  如何实现建站之星域名转发设置？  什么是javascript作用域_全局和局部作用域有什么区别？  php打包exe后无法访问网络共享_共享权限设置方法【教程】  C++用Dijkstra(迪杰斯特拉)算法求最短路径  如何在局域网内绑定自建网站域名？  佐糖AI抠图怎样调整抠图精度_佐糖AI精度调整与放大细化操作【攻略】  微信小程序 HTTPS报错整理常见问题及解决方案  成都网站制作公司哪家好,四川省职工服务网是做什么用？  网站建设要注意的标准 促进网站用户好感度！  如何挑选优质建站一级代理提升网站排名？  如何选择PHP开源工具快速搭建网站？  如何用西部建站助手快速创建专业网站？  Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布  微信公众帐号开发教程之图文消息全攻略  谷歌浏览器下载文件时中断怎么办 Google Chrome下载管理修复  Laravel策略(Policy)如何控制权限_Laravel Gates与Policies实现用户授权  太平洋网站制作公司,网络用语太平洋是什么意思？  微信小程序 五星评分(包括半颗星评分)实例代码  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)  HTML 中如何正确使用模板变量为元素的 name 属性赋值  Python制作简易注册登录系统  电商网站制作价格怎么算,网上拍卖流程以及规则？  微信小程序 闭包写法详细介绍  Laravel如何使用Laravel Vite编译前端_Laravel10以上版本前端静态资源管理【教程】  Laravel如何发送邮件和通知_Laravel邮件与通知系统发送步骤  Laravel安装步骤详细教程_Laravel环境搭建指南  Laravel如何实现一对一模型关联？（Eloquent示例）  无锡营销型网站制作公司,无锡网选车牌流程？  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  教你用AI润色文章，让你的文字表达更专业  iOS发送验证码倒计时应用  怎么用AI帮你为初创公司进行市场定位分析？  深入理解Android中的xmlns:tools属性  如何彻底卸载建站之星软件？  如何为不同团队 ID 动态生成多个非值班状态按钮  敲碗10年！Mac系列传将迎来「触控与联网」双革新  Laravel怎么实现验证码功能_Laravel集成验证码库防止机器人注册  Laravel如何从数据库删除数据_Laravel destroy和delete方法区别  PHP正则匹配日期和时间(时间戳转换)的实例代码  如何获取PHP WAP自助建站系统源码？  北京网站制作的公司有哪些,北京白云观官方网站？  Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】  如何用JavaScript实现文本编辑器_光标和选区怎么处理  电商网站制作多少钱一个,电子商务公司的网站制作费用计入什么科目？