PHP导出CSV文件教程：步骤详解

在PHP中导出数据到CSV文件是一个常见需求，本文详细介绍了如何实现这一功能。关键步骤包括准备数据源、设置响应头触发浏览器下载、使用fputcsv函数输出内容以及处理中文乱码问题。通过正确设置HTTP响应头和添加UTF-8 BOM头，可以确保CSV文件在Excel中正确显示，特别是包含中文数据时。掌握这些步骤和细节，可以轻松导出用户列表、订单记录等数据。

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学习网公众号，给大家分享更多文章知识！