当前位置：首页 > 文章列表 > 文章 > php教程 > PHP读写CSV文件方法详解

PHP读写CSV文件方法详解

2025-11-16 20:56:01 0浏览收藏

本文详细介绍了PHP读写CSV文件的实用教程，旨在帮助开发者高效处理CSV数据。文章重点讲解了`fgetcsv()`和`fputcsv()`函数的核心作用，通过流式读写实现对CSV文件的高效操作。教程涵盖了文件打开、逐行解析、数据写入等关键步骤，并深入探讨了中文CSV文件常见的编码问题，提供了GBK转UTF-8的解决方案。同时，还针对大文件CSV的读写，提出了利用生成器避免内存溢出的策略。此外，文章还总结了CSV文件处理时常见的陷阱与最佳实践，例如明确编码转换、参数化分隔符和引用符，以及防范Excel公式注入等安全问题，助力开发者编写健壮、高效的CSV处理代码。

答案：PHP处理CSV文件的核心是fgetcsv()和fputcsv()函数，通过流式读写实现高效操作。首先使用fopen()打开文件，读取时结合fgetcsv()逐行解析，写入时用fputcsv()自动处理字段引用，同时注意编码转换（如GBK转UTF-8）、跳过或写入BOM头以兼容Excel，并通过生成器或逐行处理避免大文件内存溢出，最后务必fclose()释放句柄。

PHP如何处理CSV文件_CSV文件读写操作教程

PHP处理CSV文件，核心就是利用其内置的文件系统函数，尤其是fgetcsv()用于读取，fputcsv()用于写入。这套机制相当高效且直接，只要你掌握了文件打开、迭代和关闭的基本逻辑，就能轻松应对绝大部分CSV操作需求。说白了，就是把CSV当成一个结构化的文本文件来处理，一行一行地读写，字段之间用特定分隔符隔开。

解决方案

在PHP中处理CSV文件，无论是读取还是写入，都离不开几个关键步骤和函数。我个人觉得，理解这些函数的参数和返回值，是搞定CSV操作的关键。

1. 读取CSV文件

读取CSV文件通常涉及打开文件、逐行解析、然后关闭文件。fgetcsv()是这里的核心。

<?php

function readCsvFile(string $filePath, string $delimiter = ',', string $enclosure = '"'): array
{
    $data = [];
    if (!file_exists($filePath) || !is_readable($filePath)) {
        // 实际项目中这里可能抛出异常或返回错误码
        error_log("Error: CSV file not found or not readable at " . $filePath);
        return $data;
    }

    // 尝试以只读模式打开文件
    if (($handle = fopen($filePath, 'r')) !== FALSE) {
        // 跳过UTF-8 BOM头，如果存在的话。这是处理中文CSV时常遇到的一个坑。
        // 我通常会在读取第一行之前检查并跳过。
        $bom = fread($handle, 3);
        if ($bom !== "\xEF\xBB\xBF") {
            rewind($handle); // 如果没有BOM，则重置文件指针
        }

        while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== FALSE) {
            // fgetcsv会返回一个数组，或者在文件末尾返回false
            if ($row === null) { // 遇到空行或者解析错误时，fgetcsv可能返回null
                continue;
            }
            $data[] = $row;
        }
        fclose($handle); // 记得关闭文件句柄
    } else {
        error_log("Error: Could not open CSV file for reading at " . $filePath);
    }
    return $data;
}

// 示例用法：
// 假设有一个名为 'example.csv' 的文件
// header1,header2,header3
// value1,value2,"value with, comma"
// "another value",value4,value5

// $csvData = readCsvFile('example.csv');
// print_r($csvData);

/*
输出可能类似：
Array
(
    [0] => Array
        (
            [0] => header1
            [1] => header2
            [2] => header3
        )

    [1] => Array
        (
            [0] => value1
            [1] => value2
            [2] => value with, comma
        )

    [2] => Array
        (
            [0] => another value
            [1] => value4
            [2] => value5
        )

)
*/

?>

fgetcsv()的第二个参数length，我通常设为0，这表示不限制行长度，让PHP自己处理，避免了因为行太长而导致数据截断的问题。

2. 写入CSV文件

写入CSV文件与读取类似，也是打开文件、逐行写入、然后关闭。fputcsv()是写入的核心。

<?php

function writeCsvFile(string $filePath, array $data, string $delimiter = ',', string $enclosure = '"'): bool
{
    // 确保目录存在且可写
    $dir = dirname($filePath);
    if (!is_dir($dir) && !mkdir($dir, 0777, true)) {
        error_log("Error: Could not create directory for CSV file at " . $dir);
        return false;
    }

    // 尝试以写入模式打开文件。'w'会清空文件，'a'会追加。
    // 我这里用'w'作为默认，如果你需要追加，可以修改。
    if (($handle = fopen($filePath, 'w')) !== FALSE) {
        // 写入UTF-8 BOM头，这对于确保Excel正确识别UTF-8编码的中文CSV很有帮助
        fwrite($handle, "\xEF\xBB\xBF");

        foreach ($data as $row) {
            // fputcsv期望一个数组作为行数据
            if (!is_array($row)) {
                error_log("Warning: Skipping non-array row data during CSV writing.");
                continue;
            }
            fputcsv($handle, $row, $delimiter, $enclosure);
        }
        fclose($handle);
        return true;
    } else {
        error_log("Error: Could not open CSV file for writing at " . $filePath);
        return false;
    }
}

// 示例用法：
// $dataToWrite = [
//     ['Name', 'Age', 'City'],
//     ['Alice', 30, 'New York'],
//     ['Bob', 24, 'London'],
//     ['Charlie', 35, 'Paris, France'] // 注意带逗号的字段会被正确引用
// ];

// $success = writeCsvFile('output.csv', $dataToWrite);
// if ($success) {
//     echo "CSV file 'output.csv' written successfully.";
// } else {
//     echo "Failed to write CSV file.";
// }

?>

fputcsv()会自动处理字段中的分隔符和引号，例如，如果一个字段本身包含逗号，它会自动用双引号将该字段包起来，这省去了我们手动处理的麻烦。

如何处理CSV文件中的编码问题？

说实话，CSV文件的编码问题是我在实际开发中遇到最多的“拦路虎”，尤其是当你需要处理来自不同系统、不同地区（比如国内和国外）的CSV文件时。PHP内部默认是UTF-8，但CSV文件可能来自GBK、ISO-8859-1（Latin-1）或者Windows-1252等编码，一旦编码不匹配，就会出现乱码。

问题根源： CSV文件本身不包含编码信息，它只是纯文本。所以，当你用PHP读取一个非UTF-8编码的CSV文件时，PHP会尝试将其作为UTF-8来解释，结果自然是“天书”。特别是中文环境，GBK编码的CSV非常常见。另一个小麻烦是UTF-8 BOM（Byte Order Mark），它是一个在文件开头用来标识UTF-8编码的特殊字节序列，Excel等软件喜欢它，但PHP的fgetcsv可能会把它当作第一个字段的一部分读进去。

解决方案：

检测编码（尝试性）:mb_detect_encoding()函数可以尝试检测文件的编码，但它并非万能，尤其是对于短小或者内容不够丰富的文本，检测结果可能不准确。不过，作为第一步尝试，它还是有用的。

$content = file_get_contents($filePath);
$detectedEncoding = mb_detect_encoding($content, ['UTF-8', 'GBK', 'BIG5', 'EUC-CN', 'CP936', 'Windows-1252', 'ISO-8859-1'], true);
// 这里的true表示严格模式
if ($detectedEncoding === false) {
    // 无法检测到，可能需要手动指定或猜测
    error_log("Warning: Could not reliably detect encoding for " . $filePath);
    // 尝试默认GBK或UTF-8
    $detectedEncoding = 'GBK'; // 或者 'UTF-8'
}
echo "Detected encoding: " . $detectedEncoding . "\n";

转换编码： 一旦确定了原始编码，就可以使用iconv()或mb_convert_encoding()函数将其转换为PHP内部更方便处理的UTF-8编码。我个人更倾向于mb_convert_encoding()，因为它对多字节字符处理得更好。

示例：读取GBK编码的CSV并转换为UTF-8

<?php
function readGbkCsvToUtf8(string $filePath, string $delimiter = ',', string $enclosure = '"'): array
{
    $data = [];
    if (!file_exists($filePath) || !is_readable($filePath)) {
        error_log("Error: CSV file not found or not readable at " . $filePath);
        return $data;
    }

    if (($handle = fopen($filePath, 'r')) !== FALSE) {
        while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== FALSE) {
            if ($row === null) {
                continue;
            }
            // 将每一行数据从GBK转换为UTF-8
            $convertedRow = array_map(function($field) {
                // 忽略空字符串的转换，避免不必要的错误
                return $field === '' ? '' : mb_convert_encoding($field, 'UTF-8', 'GBK');
            }, $row);
            $data[] = $convertedRow;
        }
        fclose($handle);
    } else {
        error_log("Error: Could not open CSV file for reading at " . $filePath);
    }
    return $data;
}

// 示例：假设 'gbk_example.csv' 是一个GBK编码的CSV文件
// $gbkData = readGbkCsvToUtf8('gbk_example.csv');
// print_r($gbkData);
?>

处理UTF-8 BOM： 如前所述，UTF-8 BOM是一个特殊的字节序列\xEF\xBB\xBF。在读取时，如果CSV文件带有BOM，fgetcsv()可能会将它作为第一个字段的前缀。最简单的处理方式是在读取文件后，检查第一个字段是否包含BOM，并将其移除。
```
// 在读取循环内部，处理第一行数据时
// $row = fgetcsv($handle, ...);
if (!empty($row) && isset($row[0])) {
    // 检查并移除BOM
    if (substr($row[0], 0, 3) === "\xEF\xBB\xBF") {
        $row[0] = substr($row[0], 3);
    }
}
```
或者更优雅一点，像我在readCsvFile函数中那样，在fopen之后，fgetcsv之前，直接fread3个字节来跳过BOM。这通常更可靠。

大文件CSV如何高效读写，避免内存溢出？

处理大型CSV文件时，最常见的陷阱就是试图一次性将整个文件读入内存。这对于几MB的小文件可能不是问题，但对于几十MB、几百MB甚至更大的文件，很快就会导致PHP脚本内存耗尽（"Allowed memory size of X bytes exhausted"）。高效读写大型CSV的关键在于“流式处理”——即一次只处理文件的一小部分（通常是一行），而不是全部。

1. 高效读取：fgetcsv()的真正力量

我前面展示的readCsvFile函数，其实就是一种高效读取的方式。fgetcsv()函数本身就是为流式处理设计的。它每次只从文件句柄中读取一行，并将其解析成数组返回。这意味着无论你的CSV文件有多大，fgetcsv()在任何给定时间点，都只会在内存中保留当前处理的这一行数据，以及你可能已经积累起来的少量处理结果。

// 再次强调 fgetcsv 的用法，它本身就是高效的
if (($handle = fopen($filePath, 'r')) !== FALSE) {
    // ... BOM处理 ...
    while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== FALSE) {
        // 在这里直接处理 $row，而不是将所有行都存入一个大数组
        // 例如：将数据写入数据库、进行计算、筛选等
        // processRow($row);
        // 如果你需要收集部分数据，也要注意控制收集量，比如每1000行批量处理一次
    }
    fclose($handle);
}

2. 高效写入：逐行输出

与读取类似，写入大文件也应该逐行进行。不要在内存中构建一个巨大的二维数组，然后一次性传给fputcsv()的循环。如果你需要将大量数据写入CSV，并且这些数据本身就来源于一个大型数据集（例如数据库查询结果），那么你应该从源头获取一行数据，立即写入CSV，而不是先全部加载到内存。

// 假设 $largeDataSource 是一个可以迭代的大型数据源，比如数据库结果集
function writeLargeCsv(string $filePath, iterable $largeDataSource, string $delimiter = ',', string $enclosure = '"'): bool
{
    if (($handle = fopen($filePath, 'w')) !== FALSE) {
        fwrite($handle, "\xEF\xBB\xBF"); // 写入BOM

        foreach ($largeDataSource as $row) {
            // 确保 $row 是一个数组
            if (is_array($row)) {
                fputcsv($handle, $row, $delimiter, $enclosure);
            } else {
                error_log("Warning: Skipping non-array item from large data source.");
            }
        }
        fclose($handle);
        return true;
    }
    return false;
}

// 示例：从数据库中获取数据并写入CSV
// $stmt = $pdo->query("SELECT name, email, address FROM users WHERE status = 'active'");
// writeLargeCsv('active_users.csv', $stmt); // PDOStatement是可迭代的

3. 利用PHP生成器（Generators）

对于PHP 5.5及更高版本，生成器（yield关键字）是处理大型数据集的利器。它可以让你编写看起来像返回一个数组的函数，但实际上它在每次迭代时只“生成”一个值，从而极大地节省内存。

示例：使用生成器读取CSV

<?php
function csvRowsGenerator(string $filePath, string $delimiter = ',', string $enclosure = '"'): Generator
{
    if (!file_exists($filePath) || !is_readable($filePath)) {
        throw new \RuntimeException("CSV file not found or not readable at " . $filePath);
    }

    if (($handle = fopen($filePath, 'r')) !== FALSE) {
        // 尝试跳过BOM
        $bom = fread($handle, 3);
        if ($bom !== "\xEF\xBB\xBF") {
            rewind($handle);
        }

        while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== FALSE) {
            if ($row === null) {
                continue;
            }
            yield $row; // 每次迭代时返回一行数据
        }
        fclose($handle);
    } else {
        throw new \RuntimeException("Could not open CSV file for reading at " . $filePath);
    }
}

// 示例用法：
// try {
//     foreach (csvRowsGenerator('large_data.csv') as $rowIndex => $row) {
//         // 处理每一行数据，内存占用极低
//         // echo "Row " . $rowIndex . ": " . implode(', ', $row) . "\n";
//         // insertIntoDatabase($row);
//     }
// } catch (\RuntimeException $e) {
//     error_log("Error processing CSV: " . $e->getMessage());
// }
?>

使用生成器，你的代码会变得更加简洁和内存友好。你可以在foreach循环中直接处理每一行，而无需担心整个文件被加载到内存。

CSV文件处理时常见的陷阱和最佳实践有哪些？

在处理CSV文件时，虽然PHP提供了强大的内置函数，但仍然有一些常见的陷阱需要注意，同时也有一些最佳实践可以遵循，以确保你的代码健壮、高效且不易出错。

常见的陷阱：

编码问题（老生常谈，但真的太重要了）： 我已经强调过多次，这是最让人头疼的问题。如果你不明确CSV文件的编码并进行相应的转换，乱码几乎是必然的。特别是当你的系统需要处理来自不同源的CSV时，这个问题会变得更加复杂。
不一致的分隔符和引用符： CSV标准本身就有点“模糊”，有些文件用逗号，有些用分号，甚至有些用制表符（Tab-separated values, TSV）。引用符也可能不是双引号。如果你不确定，或者CSV文件格式不一致，fgetcsv()可能会解析失败，导致数据错位。
空行或格式错误的行： 有些CSV文件可能包含空行，或者某些行的数据字段数量不匹配。fgetcsv()在遇到空行时可能会返回null或false，你需要检查这些返回值并决定如何处理（跳过、记录错误等）。
路径和权限问题： 文件不存在、路径错误、或者PHP脚本没有读写权限，都会导致fopen()失败。务必检查fopen()的返回值，并进行错误处理。
安全漏洞（Excel公式注入）： 如果你的CSV文件是提供给用户下载，并且数据来源于用户输入，那么要警惕Excel公式注入攻击。恶意用户可以在字段中插入类似=CMD("calc.exe")或=HYPERLINK("http://malicious.com")的公式。当用户在Excel中打开并点击时，可能会执行恶意代码或跳转到恶意链接。务必对用户提供的CSV数据进行清洗和验证，尤其是在写入文件之前。 最简单的方法是，对于任何以=, +, -, @开头的字段，在其前面加上一个单引号'，例如'="CMD(...)"，这样Excel会将其视为文本而不是公式。
忘记关闭文件句柄： fopen()之后，无论操作成功与否，最终都应该调用fclose()来释放文件句柄。虽然PHP脚本执行完毕会自动关闭所有打开的文件，但在长时间运行的脚本或循环中，不及时关闭可能导致资源耗尽。