首页 > 文章 > php教程

PHP下载CSV文件的正确方法

时间：2026-03-08 13:58:59 323浏览收藏

本文详解了PHP中生成下载CSV文件及解析上传CSV文件的完整实践方案，涵盖设置正确HTTP响应头强制浏览器下载、使用fputcsv高效写入数据、通过添加UTF-8 BOM解决Excel中文乱码问题，以及利用fgetcsv安全逐行解析上传文件的关键技巧，同时强调编码转换（如GBK转UTF-8）和流操作（如php://output）等易被忽视却至关重要的细节，助开发者避开常见坑点，实现稳定可靠的CSV数据交互。

如何下载php csv文件_下载php处理csv文件的相关文件方法

下载和处理 PHP 中的 CSV 文件是开发中常见的需求，比如导出数据库数据为 CSV 或读取上传的 CSV 文件进行解析。下面介绍如何通过 PHP 生成并下载 CSV 文件，以及如何读取和处理已有的 CSV 文件。

生成并下载 CSV 文件

使用 PHP 可以轻松将数组数据输出为 CSV 并强制浏览器下载。

关键点是设置正确的 HTTP 头信息，告诉浏览器这是一个需要下载的文件，并指定内容类型为 CSV。

设置响应头：使用 header() 函数发送 Content-Type 和 Content-Disposition 头。
写入数据：使用 fputcsv() 将数组写入输出流。
示例代码：

<?php
// 要导出的数据
$data = [
    ['姓名', '年龄', '城市'],
    ['张三', '25', '北京'],
    ['李四', '30', '上海'],
    ['王五', '28', '广州']
];

// 设置下载 headers
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=users.csv');

// 打开输出流
$output = fopen('php://output', 'w');

// 写入 BOM（解决中文乱码）
fprintf($output, chr(0xEF).chr(0xBB).chr(0xBF));

// 写入数据
foreach ($data as $row) {
    fputcsv($output, $row);
}

// 关闭输出流
fclose($output);
exit;

读取并解析上传的 CSV 文件

当用户上传 CSV 文件时，PHP 可以通过 fgetcsv() 逐行读取并解析内容。

获取上传文件：通过 $_FILES 获取临时文件路径。
打开文件：使用 fopen() 打开上传的文件。
逐行解析：使用 fgetcsv() 解析每一行数据。
示例代码：

<?php
if ($_POST && isset($_FILES['csv_file'])) {
    $file = $_FILES['csv_file']['tmp_name'];
    
    if (($handle = fopen($file, 'r')) !== FALSE) {
        while (($row = fgetcsv($handle, 1000, ',')) !== FALSE) {
            // 处理每一行数据
            echo '姓名：' . $row[0] . '，年龄：' . $row[1] . '<br>';
        }
        fclose($handle);
    }
}
?>
<form method="post" enctype="multipart/form-data">
    &lt;input type=&quot;file&quot; name=&quot;csv_file&quot; accept=&quot;.csv&quot; /&gt;
    <button type="submit">上传并解析</button>
</form>