手把手教你用PHP轻松导出CSV文件（附代码详解）

还在为PHP数据导出烦恼吗？本文手把手教你如何使用PHP导出CSV文件，轻松搞定数据导出需求。本文重点讲解PHP导出CSV文件的四个关键步骤：**准备数据源**、**设置响应头触发下载**、**使用fputcsv函数输出内容**以及**处理中文乱码问题**。其中，设置正确的HTTP响应头，利用`fputcsv()`函数配合`php://output`直接输出到浏览器，以及添加UTF-8 BOM头解决Excel中文乱码问题是关键。掌握这些技巧，让你在实际开发中高效、无误地导出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学习网公众号！