php如何操作csv文件_php导入导出csv数据方法-php教程-PHP中文网

php如何操作csv文件_php导入导出csv数据方法

冰火之心

发布： 2025-08-30 17:00:02

原创

742人浏览过

答案是：PHP通过fgetcsv和fputcsv函数实现CSV文件的导入导出，结合fopen、fclose进行文件操作，导入时逐行读取并关联表头，导出时设置正确HTTP头并输出到浏览器，处理大文件需采用边读边处理、分批插入、CLI模式或队列异步执行等策略以优化内存和执行时间。

php如何操作csv文件_php导入导出csv数据方法

PHP操作CSV文件，无论是导入还是导出数据，核心都围绕着PHP内置的

fgetcsv

登录后复制

和

fputcsv

登录后复制

这两个函数。它们提供了高效且灵活的方式来处理CSV的读写，是数据交换场景下的得力助手。理解并善用这两个函数，能让你轻松应对大部分CSV处理需求。

解决方案

说实话，处理CSV文件在PHP里，初看可能觉得有点麻烦，毕竟涉及文件IO，但实际上，PHP内置的那些文件操作函数，比如

fopen

登录后复制

、

fgetcsv

登录后复制

、

fputcsv

登录后复制

，用起来真是相当顺手。我个人觉得，只要理解了它们的工作原理，导入导出就不是什么难事了。

导入CSV数据： 通常，我们从用户那里拿到一个CSV文件，或者从某个地方下载下来。第一步总是打开它。

<?php
$filePath = 'data.csv'; // 假设这是你的CSV文件路径

if (!file_exists($filePath)) {
    die("错误：文件 {$filePath} 不存在。");
}

$file = fopen($filePath, 'r'); // 以只读模式打开文件

if ($file === false) {
    die("错误：无法打开文件 {$filePath}。请检查文件权限。");
}

$data = [];
$header = [];
$isHeader = true;

while (($row = fgetcsv($file, 1000, ',')) !== false) { // 每次读取一行，最大长度1000，逗号分隔
    if ($isHeader) {
        $header = $row;
        $isHeader = false;
        continue;
    }
    // 假设我们想把每一行数据关联到表头
    $rowData = [];
    foreach ($header as $index => $colName) {
        $rowData[$colName] = $row[$index] ?? null; // 防止列数不匹配
    }
    $data[] = $rowData;
}

fclose($file); // 关闭文件

echo "<pre>";
print_r($data);
echo "</pre>";

// 实际应用中，你会把 $data 导入到数据库或者进行其他处理
?>

登录后复制

这里有个小细节，

fgetcsv

登录后复制

的第二个参数是最大行长，虽然现代系统内存充足，但设一个合理的限制还是个好习惯，避免潜在的内存溢出，尤其是在处理非常大的文件时。第三个参数是分隔符，默认就是逗号，但你也可以改成制表符或其他。

导出CSV数据： 导出相对来说更直接一点，因为数据源通常是我们自己程序内部的数组或者数据库查询结果。关键在于设置正确的HTTP头，让浏览器知道这是一个要下载的文件。

<?php
// 假设这是我们要导出的数据
$exportData = [
    ['姓名', '年龄', '城市'],
    ['张三', '30', '北京'],
    ['李四', '25', '上海'],
    ['王五', '35', '广州']
];

$fileName = 'export_data_' . date('YmdHis') . '.csv';

header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="' . $fileName . '"');
header('Cache-Control: max-age=0'); // 避免浏览器缓存

$output = fopen('php://output', 'w'); // 直接输出到浏览器

if ($output === false) {
    die("错误：无法创建输出流。");
}

// 写入BOM头，解决Excel打开CSV中文乱码问题
fwrite($output, "\xEF\xBB\xBF"); 

foreach ($exportData as $row) {
    // 如果需要，可以在这里对数据进行编码转换，例如：
    // $encodedRow = array_map(function($item) {
    //     return mb_convert_encoding($item, 'GBK', 'UTF-8'); 
    // }, $row);
    fputcsv($output, $row); // 将每一行写入CSV
}

fclose($output);
exit(); // 确保不再输出其他内容
?>

登录后复制

这里我用了

php://output

登录后复制

，这真是个妙招，它允许你直接向HTTP响应体写入数据，而不需要先保存到服务器上的临时文件。这对于即时下载非常方便。另外，关于字符编码，这是一个常被忽略但又非常重要的问题。如果你的数据包含中文，强烈建议在

fputcsv

登录后复制

之前处理一下编码，比如写入UTF-8 BOM格式，这样Excel打开才不会乱码。不过，现在大部分现代软件都能很好地处理UTF-8，所以BOM头可能不是每次都必须，但了解它能帮你解决很多头疼的问题。

立即学习“PHP免费学习笔记（深入）”；

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

查看详情

PHP处理超大CSV文件时，有哪些性能优化策略？

处理大型CSV文件，说实话，是个挑战，尤其是当文件大小达到几十上百兆，甚至几个G的时候。我遇到过几次因为文件太大导致服务器直接内存溢出或者执行超时的情况。所以，单纯的循环读取写入肯定是不够的，得有点策略。

首先，内存管理是重中之重。PHP的

memory_limit

登录后复制

默认值可能不够。但你不能无限调高，那不是解决问题的根本。

fgetcsv

登录后复制

本身就是逐行读取的，这很好，因为它不会一次性把整个文件加载到内存里。但如果你把每一行都存到一个大数组里（就像我上面导入示例那样），最终还是会撑爆内存。所以，正确的做法是边读边处理。例如，每读取1000行，就批量插入到数据库，然后清空当前批次的数据，而不是把所有数据都收集起来。

其次，执行时间。

max_execution_time

登录后复制

是另一个瓶颈。对于导入操作，如果数据量巨大，可能需要几分钟甚至更久。这时候，你可以考虑：

分批处理：不是一次性处理完所有数据，而是通过前端上传分片，或者后端脚本分批执行，配合队列服务（如Redis、RabbitMQ）异步处理。
CLI模式：如果是在命令行下运行PHP脚本（
```
php your_script.php
```
登录后复制
），
```
max_execution_time
```
登录后复制
通常是无限的，这对于后台任务非常合适。

再者，**文件

以上就是php如何操作csv文件_php导入导出csv数据方法的详细内容，更多请关注php中文网其它相关文章！