PHP下载CSV文件的正确方法

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

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

生成并下载 CSV 文件

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

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

<?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() 逐行读取并解析内容。

<?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>

处理中文编码问题

CSV 文件在 Excel 中打开出现乱码，通常是因为编码不匹配。解决方案如下：

相关函数说明

PHP 提供了几个核心函数用于处理 CSV：

基本上就这些。只要掌握好 header 设置、流操作和编码处理，PHP 操作 CSV 文件并不复杂但容易忽略细节。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~