ThinkPHP 数据导出Excel与CSV格式【工具】

落丽大大_9177

落丽大大_9177

2026-10-09

246人浏览

原创

小项目优先用csv导出,大文件或需样式/多sheet时选phpspreadsheet;csv需加utf-8 bom防乱码,excel导出前须ob_end_clean()并设正确响应头,控制器末尾必须exit。

thinkphp 数据导出excel与csv格式【工具】

ThinkPHP 中导出 Excel 和 CSV 主要靠轻量原生方案或成熟第三方库,选哪种取决于数据量、格式要求和维护成本。小项目用 CSV 最快最稳;需要合并单元格、样式、多 sheet 或兼容老 Office,则必须上 PhpSpreadsheet(PHPExcel 已停止维护)。

CSV 导出:简单高效,适合大数据

无需额外扩展,纯 PHP 原生实现,内存友好,中文需加 BOM 防乱码:

  • 设置响应头:Content-Type: text/csv; charset=utf-8 + Content-Disposition: attachment; filename="data.csv"
  • 用 fopen('php://output', 'w') 打开输出流
  • 写入 UTF-8 BOM:fputs($fp, "\xEF\xBB\xBF"),避免 Excel 打开中文乱码
  • 表头和每行数据都用 fputcsv($fp, $row) 写入,自动处理逗号、换行、引号转义
  • 导出完立即 fclose($fp); exit;,防止 ThinkPHP 调试信息(如 think_page_trace)混入文件

Excel 导出:推荐 PhpSpreadsheet(非PHPExcel)

PHPExcel 已于 2019 年归档,ThinkPHP 5/6 应统一使用 phpoffice/phpspreadsheet:

QuickBooks Mileage CSV
QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证,从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载
  • 安装:composer require phpoffice/phpspreadsheet
  • 创建 Spreadsheet 对象,用 getActiveSheet() 获取当前页
  • 用 setCellValue('A1', '姓名') 逐单元格写入,或用 fromArray() 批量导入二维数组
  • 支持设置列宽、字体、背景色、边框、公式、超链接等高级功能
  • 导出前清空缓冲:ob_end_clean(),再设响应头:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

ThinkPHP 封装技巧:复用与解耦

把导出逻辑从控制器移出,提升可维护性:

  • 写一个通用导出方法(如 exportCsv($data, $headers, $filename)),放在 common/function.php 或自定义服务类中
  • 对大数据量(如 >1 万行),改用分页查询 + 边查边写,避免 select() 全加载导致内存溢出
  • 字段映射建议分离:传入数据库字段名数组(如 ['id','username','created_at'])和显示名数组(如 ['ID','用户名','注册时间']),便于后期调整
  • 导出接口禁用模板渲染,控制器末尾加 exit 是硬性要求,否则可能输出 HTML 污染文件

避坑提醒:编码、缓存与兼容性

实际部署中最常出问题的几个点:

  • 中文乱码:CSV 必加 BOM;Excel 写入前不转编码,PhpSpreadsheet 默认 UTF-8,确保数据库和 PHP 文件都是 UTF-8
  • 下载失败/空白文件:检查是否有 warning 输出(如 notice)、是否漏了 exit、是否开启了 output buffering 却未 clean
  • Excel 打开报“文件格式与扩展名不匹配”:确认响应头中 Content-Type 匹配后缀(.xlsx → openxmlformats...,.xls → ms-excel),不要混用
  • 大文件超时:PHP 配置调高 max_execution_time 和 memory_limit,生产环境建议异步导出+消息队列

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

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

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

下载

相关标签:

thinkphp php excel csv

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

相关专题

更多
thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

3841

7

thinkphp性能怎么样
thinkphp性能怎么样

thinkphp 是一款高性能的 php 框架,具备缓存机制、代码优化、并行处理和数据库优化等优势。官方性能测试显示,它每秒可处理超过 10,000 个请求,实际应用中被广泛用于京东商城、携程网等大型网站和企业系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

1300

7

ThinkPHP6后台管理系统开发与RBAC权限控制实践
ThinkPHP6后台管理系统开发与RBAC权限控制实践

本专题围绕 ThinkPHP6 在后台管理系统开发中的应用展开,重点讲解基于 RBAC 模型的权限控制实现方案。内容涵盖管理员角色设计、菜单权限分配、接口鉴权、中间件拦截机制以及后台模块化开发思路。同时结合实际案例,讲解如何构建完整的后台管理系统,包括用户管理、权限管理与操作日志记录,帮助开发者搭建安全、可扩展的企业级后台系统。

2026.03.20

523

14

ThinkPHP API接口开发与前后端分离实战
ThinkPHP API接口开发与前后端分离实战

本专题围绕ThinkPHP在前后端分离项目中的 API 开发展开,系统讲解 RESTful 接口设计规范、统一返回结构、参数验证与异常处理机制。内容涵盖 Token 鉴权、跨域处理、接口版本管理以及接口文档生成方案。通过完整项目案例,帮助开发者构建规范、高效、易维护的后端接口服务体系。

2026.03.20

344

14

ThinkPHP ORM模型关系与数据库操作优化实践
ThinkPHP ORM模型关系与数据库操作优化实践

本专题聚焦ThinkPHP中 ORM 模型的高级用法与数据库操作优化技巧。内容包括一对一、一对多、多对多关系定义与使用、关联预加载、查询构建器优化以及复杂查询封装方法。同时结合实际业务场景,讲解如何避免 N+1 查询问题、提升数据库访问效率,帮助开发者编写高性能的数据访问层代码。

2026.03.20

239

18

ThinkPHP模型详解
ThinkPHP模型详解

本专题整合了ThinkPHP模型相关内容,阅读专题下面的文章了解更多详细介绍。

2026.03.26

278

27

ThinkPHP表单验证与数据安全处理实战
ThinkPHP表单验证与数据安全处理实战

本专题聚焦 ThinkPHP 在表单处理中的验证与安全机制,系统讲解验证器使用、自定义规则、场景验证以及错误提示处理。内容涵盖 XSS 防护、SQL 注入防御、数据过滤与输入校验等关键安全措施。通过实际案例,帮助开发者构建安全可靠的数据处理流程。

2026.03.30

221

20

ThinkPHP日志系统设计与异常监控实践
ThinkPHP日志系统设计与异常监控实践

本专题围绕 ThinkPHP 日志系统展开,深入讲解日志记录机制、日志级别划分、日志文件管理以及自定义日志通道配置。内容涵盖异常捕获、错误追踪、调试信息输出以及日志分析方法。通过实战讲解,帮助开发者提升系统问题定位能力与运维效率。

2026.03.30

428

18

ThinkPHP 路由机制与请求分发流程深度实践
ThinkPHP 路由机制与请求分发流程深度实践

本专题围绕 ThinkPHP 的核心路由系统展开,深入讲解路由定义、分组路由、动态参数解析及请求分发流程。内容涵盖控制器调度机制、中间件参与流程以及性能优化策略。通过源码级分析与实战案例,帮助开发者理解 ThinkPHP 的底层执行逻辑,提升项目架构设计能力。

2026.03.31

111

20

热门下载

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

精品课程

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