PHP如何解析和生成CSV文件_PHP CSV文件读写操作指南-php教程-PHP中文网

PHP处理CSV文件的核心是fgetcsv和fputcsv函数，通过fopen、循环读取或写入、fclose实现流式操作，可高效处理任意大小文件；读取时需注意BOM头和编码问题，避免中文乱码，可使用mb_convert_encoding转换；fgetcsv和fputcsv自动处理含分隔符或引号的字段，支持自定义分隔符和包围符；对于大文件，应采用逐行读取和写入策略，避免内存溢出；此外，thephpleague/csv库提供面向对象的高级API，支持数据过滤、映射、分页等特性，适合复杂场景，提升开发效率与代码健壮性。

php如何解析和生成csv文件_php csv文件读写操作指南

PHP处理CSV文件，无论是读取还是写入，核心都围绕着几个内置的文件操作函数，特别是

fgetcsv

登录后复制

和

fputcsv

登录后复制

。它们提供了一种直接且高效的方式来处理这种常见的数据交换格式，但要真正用好，理解背后的编码、分隔符和文件流处理机制至关重要。

解决方案

在PHP中操作CSV文件，我们通常会使用

fopen()

登录后复制

打开文件，然后通过循环结合

fgetcsv()

登录后复制

逐行读取数据，或者使用

fputcsv()

登录后复制

将数据写入文件，最后用

fclose()

登录后复制

关闭文件句柄。这是一种流式处理的方法，对于各种大小的文件都非常有效。

读取CSV文件示例：

<?php
$filePath = 'data.csv';
$data = [];

if (($handle = fopen($filePath, 'r')) !== FALSE) {
    // 尝试跳过可能存在的BOM头
    $bom = fread($handle, 3);
    if ($bom !== "\xEF\xBB\xBF") {
        rewind($handle); // 如果没有BOM，则将文件指针重置到开头
    }

    while (($row = fgetcsv($handle, 1000, ',')) !== FALSE) {
        // 假设CSV文件是UTF-8编码，如果不是，可能需要mb_convert_encoding
        // $row = array_map('mb_convert_encoding', $row, array_fill(0, count($row), 'UTF-8'), array_fill(0, count($row), 'GBK'));
        $data[] = $row;
    }
    fclose($handle);
}

// 此时 $data 数组中包含了CSV文件的所有行
// print_r($data);
?>

登录后复制

写入CSV文件示例：

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

<?php
$filePath = 'output.csv';
$list = [
    ['姓名', '年龄', '城市'],
    ['张三', '30', '北京'],
    ['李四', '25', '上海,中国'], // 包含逗号的字段会被自动加引号
    ['王五', '35', '广州']
];

if (($handle = fopen($filePath, 'w')) !== FALSE) {
    // 添加UTF-8 BOM，确保Excel等软件正确识别编码
    fwrite($handle, "\xEF\xBB\xBF");
    foreach ($list as $fields) {
        fputcsv($handle, $fields);
    }
    fclose($handle);
}
?>

登录后复制

fgetcsv()

登录后复制

的第二个参数是最大行长度（通常可以设为一个较大的值，或者0表示无限制，但为了安全考虑，设置一个上限是个好习惯），第三个是分隔符（默认为逗号），第四个是包围符（默认为双引号）。

fputcsv()

登录后复制

的参数类似，允许你自定义分隔符和包围符。理解并正确设置这些参数是避免解析错误的关键。

处理大型CSV文件时，内存溢出是宿命吗？——PHP分块读取与写入策略

很多时候，我们面对的CSV文件可能不是几KB，而是几十MB甚至几个GB。这时，如果直接尝试用

file_get_contents()

登录后复制

或者一次性将所有数据加载到内存中，PHP的内存限制（

memory_limit

登录后复制

）很快就会成为一个头疼的问题，导致脚本中断。我曾经就遇到过一个上百万行的数据导入任务，一开始天真地想把所有数据读进来处理，结果可想而知，直接白屏报错。

解决之道在于流式处理。PHP的文件操作函数，尤其是

fopen()

登录后复制

结合

fgetcsv()

登录后复制

和

fputcsv()

登录后复制

，天生就是为流式处理设计的。它们不会一次性将整个文件读入内存，而是每次只处理文件的一小部分（通常是一行）。

读取大型文件：

fgetcsv()

登录后复制

每次只读取一行，然后将文件指针移动到下一行。这意味着无论文件有多大，PHP脚本在任何给定时刻内存中都只保留当前处理的这一行数据（以及你可能累积起来的少量处理结果）。

<?php
// ... (fopen 部分与之前相同)
if (($handle = fopen('large_data.csv', 'r')) !== FALSE) {
    // ... (BOM 处理)
    while (($row = fgetcsv($handle, 0, ',')) !== FALSE) { // 0 表示无最大行长限制
        // 在这里直接处理每一行数据，例如：
        // 插入数据库、进行计算、筛选等
        // 不要将所有行都存入一个大数组，那样又会回到内存问题
        // echo "处理行: " . implode(', ', $row) . "\n";
    }
    fclose($handle);
}
?>

登录后复制

这种方式下，你的脚本内存消耗将保持在一个非常低的水平，只取决于你当前处理的逻辑以及临时变量。

写入大型文件： 同样，写入时也应该避免一次性构建一个巨大的数组再写入。而是应该逐行生成数据，然后立即通过

fputcsv()

登录后复制

写入文件。

<?php
// ... (fopen 部分与之前相同)
if (($handle = fopen('large_output.csv', 'w')) !== FALSE) {
    fwrite($handle, "\xEF\xBB\xBF"); // BOM
    // 假设你有大量数据需要生成并写入
    for ($i = 0; $i < 1000000; $i++) {
        $rowData = ["Item_$i", rand(1, 100), "Category_" . ($i % 10)];
        fputcsv($handle, $rowData);
    }
    fclose($handle);
}
?>

登录后复制

通过这种逐行写入的方式，你不需要在内存中保存所有待写入的数据，从而避免了内存溢出的风险。记住，流式处理是处理大文件的黄金法则。

CSV数据中的特殊字符该如何处理？——编码、分隔符与转义的那些事儿

CSV文件看似简单，但实际操作中，特殊字符、编码和分隔符常常是导致解析失败或数据错乱的罪魁祸首。我见过太多因为编码问题导致中文乱码，或者字段内容包含逗号而导致列错位的案例。

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

1. 编码问题：UTF-8 BOM 最常见的是UTF-8编码的CSV文件，尤其是在Windows环境下用Excel打开时，如果文件没有UTF-8 BOM（Byte Order Mark），Excel可能会将其识别为ANSI或其他编码，导致中文乱码。

读取时： 在
```
fopen
```
登录后复制
后，可以先读取文件开头的3个字节，检查是否是BOM (
```
\xEF\xBB\xBF
```
登录后复制
)。如果是，就跳过这3个字节；如果不是，就将文件指针重置。
写入时： 在
```
fopen
```
登录后复制
后，立即
```
fwrite($handle, "\xEF\xBB\xBF");
```
登录后复制
写入BOM，这能有效解决Excel的识别问题。

此外，如果CSV文件不是UTF-8，例如是GBK，你需要在读取每一行数据后，使用

mb_convert_encoding()

登录后复制

或

iconv()

登录后复制

将其转换为你的系统或应用程序期望的编码（通常是UTF-8）。

// 示例：将GBK编码的CSV内容转换为UTF-8
// $row = array_map(function($field) {
//     return mb_convert_encoding($field, 'UTF-8', 'GBK');
// }, $row);

登录后复制

2. 分隔符与包围符： CSV（Comma Separated Values）顾名思义是用逗号分隔。但实际中，也可能遇到用分号、制表符甚至其他字符分隔的情况。

```
fgetcsv($handle, 0, ';', '"')
```
登录后复制
：这里的第三个参数是分隔符，第四个是包围符。如果你的数据中有字段本身包含分隔符（例如“上海,中国”），那么这个字段必须被包围符（通常是双引号）包起来，
```
fgetcsv
```
登录后复制
和
```
fputcsv
```
登录后复制
会自动处理。
```
fputcsv()
```
登录后复制
在写入时会自动判断字段内容是否包含分隔符或包围符。如果包含，它会自动用包围符将整个字段括起来。如果字段内容本身就包含包围符，
```
fputcsv
```
登录后复制
还会对包围符进行转义（通常是双写，如
```
"He said ""Hello""."
```
登录后复制
）。

// 示例：字段内容包含逗号和双引号
$dataWithSpecialChars = [
    ['产品A', '描述,包含逗号', '价格 "100" 美元'],
    ['产品B', '另一个描述', '价格 "200" 美元']
];
// fputcsv会自动处理这些特殊情况
// fputcsv($handle, $dataWithSpecialChars[0]);
// 输出类似: "产品A","描述,包含逗号","价格 ""100"" 美元"

登录后复制

理解这些自动处理机制，可以避免很多手动转义的麻烦，但也要确保你的输入数据格式是规范的。

除了内置函数，还有哪些PHP库能让CSV操作更优雅？

虽然PHP的内置函数功能强大且高效，但在一些更复杂的场景，或者追求更高开发效率、更健壮的代码时，使用第三方库会是一个非常明智的选择。它们通常提供了更高级的抽象、更丰富的配置选项和更好的错误处理机制。

我个人比较推荐的是

thephpleague/csv

登录后复制

库。它是一个非常成熟、活跃且功能丰富的CSV处理库，提供了面向对象的API，让CSV操作变得更加优雅和灵活。

thephpleague/csv

登录后复制

的优势：

面向对象： 提供
```
Reader
```
登录后复制
和
```
Writer
```
登录后复制
对象，使代码更具可读性和可维护性。
丰富配置： 可以轻松设置分隔符、包围符、转义符，甚至自定义行结束符。
数据过滤与映射： 内置了方便的方法来过滤行、跳过头部、映射数据等。
内存管理： 同样支持流式处理，对大文件友好。
错误处理： 提供了更完善的异常处理机制。
更高级的特性： 例如，可以轻松地将CSV数据转换为关联数组，或者从数组生成CSV。

使用

thephpleague/csv

登录后复制

示例：

首先，通过Composer安装：

composer require thephpleague/csv

登录后复制

读取CSV文件：

<?php
require 'vendor/autoload.php';

use League\Csv\Reader;
use League\Csv\Statement;

$csv = Reader::createFromPath('data.csv', 'r');
$csv->setDelimiter(','); // 设置分隔符
$csv->setHeaderOffset(0); // 将第一行作为标题行，后续数据将以关联数组形式返回

// 获取所有记录
$records = $csv->getRecords();
foreach ($records as $record) {
    // $record 现在是一个关联数组，键是标题行中的字段名
    // print_r($record);
}

// 或者使用Statement进行过滤、排序、分页
$stmt = (new Statement())
    ->offset(1) // 跳过第一行（如果setHeaderOffset(0)已设置，这里会跳过第二行数据）
    ->limit(10); // 只获取10行

$filteredRecords = $stmt->process($csv);
foreach ($filteredRecords as $record) {
    // print_r($record);
}
?>

登录后复制

写入CSV文件：

<?php
require 'vendor/autoload.php';

use League\Csv\Writer;

$writer = Writer::createFromPath('output_library.csv', 'w+');
$writer->setDelimiter(',');
$writer->setOutputBOM(Reader::BOM_UTF8); // 添加UTF-8 BOM

$header = ['姓名', '年龄', '城市'];
$data = [
    ['张三', '30', '北京'],
    ['李四', '25', '上海,中国'],
    ['王五', '35', '广州']
];

$writer->insertOne($header); // 写入标题行
$writer->insertAll($data);   // 写入所有数据

// 也可以逐行写入
// foreach ($data as $row) {
//     $writer->insertOne($row);
// }
?>

登录后复制

在我看来，当项目规模较大、需要频繁且复杂地操作CSV文件时，引入