讲师中心 微信公众号
AI工具推荐 视频效率加速

PHP如何创建CSV文件_生成带标题行的数据导出文件【方法】

冬磊君_5560

冬磊君_5560

发布时间:2026-02-16 13:16:03

|

186人浏览过

|

来源于php中文网

原创

fputcsv() 写 CSV 需先 fopen('w'),再写标题行和数据行;导出下载须设 Content-Type 与 Content-Disposition 头且无前置输出;加 UTF-8 BOM 解决 Excel 中文乱码;大数据应边查边写防内存溢出。

php如何创建csv文件_生成带标题行的数据导出文件【方法】

用 fputcsv() 写入带标题行的 CSV 文件

PHP 原生支持 CSV 生成,核心是 fputcsv() 函数,它自动处理字段分隔、引号包裹和特殊字符转义。关键不是“手动拼字符串”,而是用文件句柄逐行写入,包括标题行。

常见错误是把标题当普通数据写、漏掉 fopen() 的 'w' 模式、或没设置 header() 导致浏览器直接显示乱码。

  • 先用 fopen($filename, 'w') 创建可写文件(注意权限)
  • 用 fputcsv($fp, $header_array) 写标题行,例如 ['姓名', '邮箱', '注册时间']
  • 循环数据,对每条记录调用 fputcsv($fp, $row),数组键名不会被写入,只写值
  • 写完必须 fclose($fp),否则内容可能未刷入磁盘

导出到浏览器下载而非保存在服务器

如果目标是让用户点击下载 CSV,就不能只写文件,得配合 HTTP 头。重点在于 Content-Type 和 Content-Disposition 的组合,且必须在任何输出前调用。

容易踩的坑:开头有空格、BOM 字节、echo 或 print 提前触发输出,导致 header 报错 “headers already sent”。

立即学习“PHP免费学习笔记(深入)”;

Knowledge Graph - Csv Graph Loader Generator
Knowledge Graph - Csv Graph Loader Generator

从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。

下载
  • 用 ob_end_clean() 清除已有的输出缓冲(谨慎使用,确认无前置输出)
  • 设置 header('Content-Type: text/csv; charset=utf-8')
  • 设置 header('Content-Disposition: attachment; filename="data.csv"')
  • 用 php://output 替代文件路径: $fp = fopen('php://output', 'w')
  • 写入完成后不需 fclose(),系统自动关闭

中文乱码问题:UTF-8 BOM 是必要手段

Excel 默认用系统编码打开 CSV,Windows 上常识别为 ANSI,导致中文变问号。加 UTF-8 BOM(\xEF\xBB\xBF)是兼容性最强的解法,不是“多此一举”。

别用 mb_convert_encoding() 强转编码——原始数据已是 UTF-8,问题出在 Excel 缺少编码提示。

  • 在写入标题前,先用 fwrite($fp, "\xEF\xBB\xBF")
  • 确保所有字段值是 UTF-8 编码(从数据库查出时就应是,如 MySQL 连接设 utf8mb4)
  • 避免用 iconv('GBK', 'UTF-8', $str) 处理字段——除非你确定源数据是 GBK

大数据量导出时避免内存溢出

一次性把几万行读进 PHP 数组再循环写入,极易触发 Allowed memory size exhausted。正确做法是边查边写,用游标式查询或分页流式读取。

MySQL 中用 SELECT ... INTO OUTFILE 虽快,但依赖服务器权限且不灵活;PHP 层控制更安全、可加逻辑。

  • 用 PDO::FETCH_ASSOC + while ($row = $stmt->fetch()) 逐行获取
  • 每写 1000 行执行一次 ob_flush() 和 flush()(仅限输出到浏览器场景)
  • 禁用 set_time_limit(0) 防止超时中断(但要评估真实需求,非必需)
  • 不要用 file_put_contents() 拼接整块 CSV 字符串——这是内存杀手
BOM 字节、流式写入、header 顺序——这三个点在实际项目里最容易被跳过,一出问题就花半天排查。

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2393

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1439

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

855

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3352

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

5748

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1239

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6011

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

5222

2023.08.14

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn