ThinkPHP5Excel如何导出_ThinkPHP5导出Excel表格数据【扩展】

阿静吖_4009

阿静吖_4009

2026-06-02

1080人浏览

原创

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

thinkphp5excel如何导出_thinkphp5导出excel表格数据【扩展】

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 是唯一靠谱选择,但初始化和写入节奏必须控制。

excel-clean
excel-clean

Excel 数据清洗——去重、填补缺失值、格式转换。

下载
  • 禁用计算引擎:$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免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

thinkphp excel php excel表格

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10204

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6021

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2095

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3788

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4494

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3531

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5017

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3922

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11902

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程