PHP导出CSV文件的详细教程

想要轻松导出PHP数据到CSV文件？本文将为你详细解析PHP导出CSV文件的完整步骤，助你快速实现用户列表、订单记录等数据的导出需求。文章重点讲解了四个关键点：**准备数据源、设置响应头触发浏览器下载、使用fputcsv函数输出内容以及处理中文乱码问题**。通过本文，你将学会如何利用`header()`函数设置响应头，使用`fputcsv()`函数将数据写入CSV文件，以及如何添加UTF-8 BOM头解决Excel中文乱码问题。掌握这些技巧，让你在实际开发中轻松应对PHP导出CSV文件的需求，提升工作效率。

PHP导出数据到CSV需注意4个关键点。1.准备好数据源，如数据库查询结果或数组；2.设置响应头触发浏览器下载，如header('Content-Type:text/csv;charset=utf-8')和header('Content-Disposition:attachment;filename=export.csv')；3.使用fputcsv函数输出内容，配合php://output直接输出到浏览器，并加exit结束脚本；4.处理中文乱码问题，在输出前添加UTF-8BOM头，确保Excel正确识别编码。

在实际开发中，PHP 导出数据到 CSV 文件是一个很常见的需求，比如导出用户列表、订单记录等。实现起来不复杂，但有几个关键点需要注意。

1. 准备数据源

导出的第一步是准备好你要输出的数据。这些数据通常来自数据库查询结果，也可能来自数组或者其他结构。

例如，从 MySQL 查询数据可以用如下代码：

$pdo = new PDO("mysql:host=localhost;dbname=test", "user", "password");
$stmt = $pdo->query("SELECT id, name, email FROM users");
$data = $stmt->fetchAll(PDO::FETCH_ASSOC);

确保数据格式是你需要导出的字段和内容，不要包含多余信息。这一步虽然简单，但一旦数据没处理干净，后面生成的 CSV 就会有问题。

2. 设置响应头，触发浏览器下载

要让浏览器识别这是一个 CSV 文件并自动弹出“另存为”对话框，你需要设置正确的 HTTP 响应头。

常用做法如下：

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=export.csv');

其中 filename 可以根据时间戳动态命名，比如 export_20250405.csv，这样避免重复覆盖。

3. 使用 fputcsv 输出 CSV 内容

PHP 提供了 fputcsv() 函数，可以很方便地把数组写入 CSV 格式。你可以配合 php://output 直接输出到浏览器。

完整示例：

$output = fopen('php://output', 'w');

// 输出表头
fputcsv($output, ['ID', '姓名', '邮箱']);

// 输出每一行数据
foreach ($data as $row) {
    fputcsv($output, $row);
}

fclose($output);
exit;

注意这里一定要调用 exit 或 die 来结束脚本执行，否则后续输出可能会污染 CSV 内容。

4. 处理中文乱码（一个容易忽略的细节）

如果你的数据里有中文，默认情况下导出的 CSV 在 Excel 中打开可能出现乱码。解决方法是在输出内容前加上 BOM 头：

echo "\xEF\xBB\xBF"; // UTF-8 BOM

这个操作要在任何 header 之前执行，并且不能有任何空格或输出。加了之后 Excel 才能正确识别编码。

基本上就这些步骤。整个流程不复杂，但要注意顺序和细节，特别是响应头、BOM 和数据格式这几个地方很容易踩坑。

终于介绍完啦！小伙伴们，这篇关于《PHP导出CSV文件的详细教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！