PHP导出CSV文件的详细教程

本文详细介绍了如何使用PHP导出数据到CSV文件的完整步骤，并着重强调了四个关键点，助你轻松解决导出难题，提升用户体验。首先，需要准备好数据源，无论是数据库查询结果还是数组，确保数据准确无误。其次，设置正确的HTTP响应头，例如`header('Content-Type:text/csv;charset=utf-8')`和`header('Content-Disposition:attachment;filename=export.csv')`，触发浏览器下载，并支持自定义文件名。接着，利用`fputcsv`函数高效输出CSV内容，配合`php://output`直接输出到浏览器，务必使用`exit`结束脚本。最后，针对中文乱码问题，提供解决方案，在输出前添加UTF-8 BOM头`echo "\xEF\xBB\xBF";`，保证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 和数据格式这几个地方很容易踩坑。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。