tp5导出excel核心是按量级和格式分路径:大数据量必须用cursor()+fputcsv导csv,禁用框架封装;小批量且需excel时,用phpspreadsheet分块fromarray写入、禁计算引擎、加bom头、配全响应头并exit。

TP5 导出 Excel 不是“装个包就能用”,核心矛盾在内存和格式兼容性上——直接 Db::select() 查 5 万条再喂给 PhpSpreadsheet,99% 会触发 Fatal error: Allowed memory size exhausted;而用 HTML 表格伪造 Excel(downloadExcel() 那种),打开就是乱码或样式崩溃。必须按量级、格式、稳定性分路径处理。
大数据量导出必须用 CSV + cursor(),别碰 Excel
Excel 格式本身不支持流式写入,PhpSpreadsheet 写入过程会缓存全部单元格对象,数据量一过 1 万行,内存占用轻松破 300MB。此时强行导 Excel 就是给自己埋雷。
- 用
Db::name('user')->cursor()替代select(),逐行取数据,内存恒定在几 MB - 输出前必须加 BOM 头:
echo "\xEF\xBB\xBF";,否则 Excel 默认用 ANSI 解码中文字段,全成问号 - 用原生
fputcsv(),别用框架封装的 exportCsv 方法——字段顺序、空值转空字符串、引号/换行自动转义都由它兜底 -
ob_end_clean()必须调用,否则响应体开头混入空白或 HTML,CSV 文件就损坏
小批量且硬要 Excel:用 PhpSpreadsheet + fromArray() 分块写入
若业务明确要求 .xlsx(比如要公式、条件格式、合并单元格),PhpSpreadsheet 是唯一靠谱选择,但初始化和写入节奏必须控制。
- 禁用计算引擎:
$spreadsheet->setCalculationEngine(new \PhpOffice\PhpSpreadsheet\Calculation\Calculation());,否则读写含公式的文件时 CPU 爆表 - 避免逐单元格赋值:
$sheet->setCellValue('A'.$row, $val)写 1 万行 = 1 万个 PHP 对象,内存翻倍;改用fromArray($chunk, null, 'A2')批量写入 - 分块写入:每 500 行 flush 一次,
$writer->save('php://output')只在最后调用一次,中间用ob_flush()推送缓冲区 - 不要用
new \PHPExcel()——这是已废弃的旧库,TP5.0 官方也不再兼容,composer require 的必须是phpoffice/phpspreadsheet
TP5.0 里加载 PhpSpreadsheet 的正确姿势
TP5.0 自带类自动加载机制,但 PhpSpreadsheet 的命名空间和目录结构与 TP 规范不完全对齐,直接 use 会报错。
- 安装后,在控制器顶部写完整命名空间:
use PhpOffice\PhpSpreadsheet\Spreadsheet;和use PhpOffice\PhpSpreadsheet\Writer\Xlsx; - 别在
common.php里写全局函数封装PhpSpreadsheet实例——每次调用都 new 一遍,对象无法复用,内存泄漏更隐蔽 - 如果非要用函数封装,务必加
static $spreadsheet = null;缓存实例,并在函数末尾unset($spreadsheet);显式释放 - vendor/autoload.php 已自动注册 PSR-4 加载器,无需再手动
Loader::import()或 require_once
导出响应头不能只写 Content-Type
只设 Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,浏览器可能识别为下载失败或弹窗拦截。必须配齐关键头。
- Excel 下载必须加:
header('Cache-Control: max-age=0');,否则某些 IE/Edge 版本会缓存旧文件 - 文件名含中文时,
filename=后面要用rawurlencode()编码,而不是iconv()转 GB2312——后者在 Linux 服务器上常因 locale 缺失直接报错 - 一定要有
Content-Disposition: attachment; filename="data.xlsx",漏掉attachment会导致浏览器内联打开,不是下载 - 导出结束必须
exit;或die;,否则后续框架输出(如调试信息、布局模板)会污染二进制流
真正卡住人的从来不是“怎么写第一行代码”,而是导出 5w 行时内存爆了没日志、中文字段在 Excel 里显示为乱码却查不出哪少了个 BOM、或者导出接口被 CDN 缓存导致用户总下到旧数据——这些点不提前踩一遍,上线就是救火现场。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











