当前位置：首页 > 文章列表 > 文章 > php教程 > PHP读取CSV文件的实用方法

PHP读取CSV文件的实用方法

2026-03-03 10:55:55 0浏览收藏

本文深入讲解了PHP读取CSV文件的完整实践方案，以核心函数fgetcsv()为主线，系统覆盖了文件安全打开、逐行解析、编码转换（如mb_convert_encoding解决GBK/UTF-8乱码）、特殊字符与多行字段的鲁棒处理（依托标准包围符机制），以及面向大型文件的高性能优化策略——包括流式逐行处理、生成器内存控制、批量数据库插入和及时内存释放等关键技巧，兼顾实用性、健壮性与工程可扩展性，是PHP开发者高效、稳定处理各类CSV场景的一站式指南。

php如何读取CSV文件内容？php解析与读取CSV数据教程

PHP读取CSV文件内容的核心在于利用内置的文件操作函数，特别是fgetcsv()，它能逐行解析CSV数据，自动处理分隔符和引号，极大地简化了开发工作。

解决方案

说实话，用PHP处理CSV文件，最直接、最常用的方法就是fgetcsv()函数。它简直是为这个场景量身定制的。我个人觉得，当你需要从CSV文件里捞数据时，脑子里第一个跳出来的就应该是它。

下面是一个基本的代码示例，展示了如何一步步地读取并解析CSV文件：

<?php

function readCsvFile(string $filePath, string $delimiter = ',', string $enclosure = '"'): array
{
    if (!file_exists($filePath)) {
        // 嘿，文件都不存在，怎么读？直接抛个异常或者返回空数组都行
        // 我倾向于抛异常，这样调用方能明确知道哪里出了问题
        throw new Exception("CSV文件不存在: " . $filePath);
    }

    $handle = fopen($filePath, 'r');
    if ($handle === false) {
        // 文件打不开？权限问题？或者路径不对？
        throw new Exception("无法打开CSV文件进行读取: " . $filePath);
    }

    $data = [];
    // 循环读取，直到文件末尾
    // fgetcsv 会自动处理一行中的分隔符和引号
    while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== false) {
        // 每次读取到一行数据，它就是一个数组
        // 我们可以根据需要进一步处理，比如存到另一个数组里
        // 或者直接打印，或者插入数据库
        $data[] = $row;
    }

    fclose($handle); // 读完了，记得关掉文件句柄，这是个好习惯
    return $data;
}

// 假设我们有一个名为 'data.csv' 的文件
// 内容可能是这样的：
// Name,Age,City
// Alice,30,"New York"
// Bob,24,"Los Angeles, CA"
// "Charlie ""The Great""",35,London

try {
    $csvData = readCsvFile('data.csv');
    echo "CSV文件内容：\n";
    foreach ($csvData as $rowIndex => $row) {
        echo "行 " . ($rowIndex + 1) . ": " . implode(' | ', $row) . "\n";
    }
} catch (Exception $e) {
    echo "读取CSV文件时发生错误: " . $e->getMessage() . "\n";
}

?>

这个函数的核心思想就是：打开文件 -> 逐行读取 -> 关闭文件。fgetcsv()的第二个参数length设置为0，意味着它会读取整行，直到遇到换行符，这对于大多数情况都适用。delimiter和enclosure参数则分别定义了字段分隔符和字段包围符，这对于正确解析CSV至关重要。

PHP读取CSV文件时，如何高效处理不同编码格式的数据？

哎，编码问题，这简直是数据处理领域的老大难了。尤其是在处理来自不同系统或地域的CSV文件时，编码不一致是家常便饭。我见过太多因为编码不对导致乱码的情况，那真是让人头疼。

通常，CSV文件可能采用UTF-8、GBK、ISO-8859-1等编码。如果你的PHP脚本默认是UTF-8，而CSV文件是GBK，直接读取出来就会是一堆乱码。

解决方案通常是：识别源文件编码并进行转换。

确定源文件编码：
- 最理想的情况是，你知道CSV文件的原始编码。比如，如果文件是从某个Windows系统导出，很可能是GBK或GB2312。
- 如果不知道，可以尝试一些编码检测库，比如mb_detect_encoding()（但它并不总是100%准确，尤其是短文本）。
- 或者，最笨但有时最有效的方法：用文本编辑器（如Notepad++，VS Code）打开文件，切换编码查看是否显示正常。

使用iconv()或mb_convert_encoding()进行转换：一旦确定了源编码，就可以在读取每一行数据后，对每个字段进行编码转换。

<?php
// ... readCsvFile 函数的修改版本 ...
function readCsvFileWithEncoding(string $filePath, string $sourceEncoding = 'GBK', string $targetEncoding = 'UTF-8', string $delimiter = ',', string $enclosure = '"'): array
{
    // ... 文件存在和打开的检查 ...

    $handle = fopen($filePath, 'r');
    if ($handle === false) {
        throw new Exception("无法打开CSV文件进行读取: " . $filePath);
    }

    $data = [];
    while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== false) {
        $convertedRow = [];
        foreach ($row as $field) {
            // 确保字段是字符串，避免对非字符串类型进行编码转换
            if (is_string($field)) {
                // 我个人更偏爱 mb_convert_encoding，因为它对多字节字符处理更稳健
                $convertedRow[] = mb_convert_encoding($field, $targetEncoding, $sourceEncoding);
            } else {
                $convertedRow[] = $field; // 非字符串类型直接保留
            }
        }
        $data[] = $convertedRow;
    }

    fclose($handle);
    return $data;
}

// 假设 'data_gbk.csv' 是一个GBK编码的文件
// try {
//     $csvData = readCsvFileWithEncoding('data_gbk.csv', 'GBK', 'UTF-8');
//     echo "GBK编码CSV文件内容（已转换）：\n";
//     foreach ($csvData as $rowIndex => $row) {
//         echo "行 " . ($rowIndex + 1) . ": " . implode(' | ', $row) . "\n";
//     }
// } catch (Exception $e) {
//     echo "读取CSV文件时发生错误: " . $e->getMessage() . "\n";
// }
?>

这里，我们把源编码和目标编码作为参数传入，这样灵活性就大大提高了。记住，如果源文件编码和你的脚本编码一致，就没必要转换了，避免不必要的性能开销。

PHP处理包含特殊字符或多行内容的CSV字段，有哪些实用技巧？

CSV格式，全称是逗号分隔值，听起来简单，但实际操作起来，那些特殊字符和多行内容可真是让人头疼。fgetcsv()在处理这些情况时，其实已经做了很多工作，但我们作为开发者，还是得了解它的机制。

核心技巧在于理解CSV的包围符（Enclosure）规则。

包围符的作用：当一个字段本身包含分隔符（比如逗号）、换行符或者包围符自身时，这个字段就需要用包围符（通常是双引号"）包起来。例如："Hello, World", "This is a multi-line\nfield"。
fgetcsv()如何处理包围符： fgetcsv()函数设计之初就考虑到了这一点。只要你的CSV文件遵循标准的CSV格式（RFC 4180），fgetcsv()就能正确解析。
- 包含分隔符的字段：fgetcsv()会自动识别被包围符包起来的字段，即使里面有分隔符，也不会被错误地分割。例如："Apple, Banana",Orange 会被解析为 ["Apple, Banana", "Orange"]。
- 包含换行符的字段（多行内容）：如果一个字段被包围符包起来，并且内部含有换行符，fgetcsv()会把整个被包围的内容作为一个字段来处理，直到找到匹配的结束包围符。例如："First line\nSecond line",Value2 会被解析为 ["First line\nSecond line", "Value2"]。
- 包围符自身作为数据：如果字段内部需要包含包围符本身，那么这个包围符需要被双写（Escaped）。例如："He said ""Hello!"" to me" 会被解析为 ["He said \"Hello!\" to me"]。fgetcsv()会自动把双写的包围符还原成单个包围符。
实用技巧：
- 明确enclosure参数：确保fgetcsv()的$enclosure参数与你的CSV文件实际使用的包围符一致。默认是双引号"，这在绝大多数情况下都适用。
- 生成CSV时遵循标准：如果你也需要生成CSV文件，务必遵循这些规则。使用fputcsv()函数是最好的选择，它会自动帮你处理字段的包围和转义。
- 数据清洗：尽管fgetcsv()处理得很好，但有时原始数据可能会有不规范的地方。读取后，你可能还需要对数据进行进一步的trim()（去除首尾空白）、stripslashes()（如果数据源有额外的斜杠转义）等操作，确保数据的干净和一致性。

我个人经验是，只要CSV文件是“规矩”生成的，fgetcsv()几乎不会出问题。但如果数据源本身就不规范，比如有些字段该加引号没加，那再好的解析器也无能为力，这时候就得考虑源头数据清洗或者更复杂的自定义解析逻辑了。

PHP读取大型CSV文件时，如何优化性能并防止内存溢出？

处理小型CSV文件，前面的方法绰绰有余。但如果你的CSV文件动辄几十兆、上百兆甚至几个G，一次性把所有数据读到内存里，那内存溢出（Allowed memory size of X bytes exhausted）的错误就等着你了。这种时候，我们必须改变策略，采用流式处理的思想。

核心思路是：逐行处理，不将整个文件加载到内存。

fgetcsv()的天然优势：其实，fgetcsv()函数本身就是为逐行读取设计的。它每次只读取一行数据到内存，处理完当前行后，内存就可以被释放或重用，而不会积累。这是它处理大型文件而不导致内存溢出的关键。

// 示例中 readCsvFile 函数就是逐行读取的，所以它本身就具有内存优化的特性。
// $data[] = $row; 这一步会把所有行都存起来，
// 如果你只是想处理数据而不存储，可以这么改：
function processLargeCsvFile(string $filePath, callable $rowProcessor, string $delimiter = ',', string $enclosure = '"')
{
    // ... 文件存在和打开的检查 ...
    $handle = fopen($filePath, 'r');
    if ($handle === false) { /* ... */ }

    while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== false) {
        // 不把所有行都存到 $data 数组里
        // 而是直接处理当前行
        $rowProcessor($row); // 调用一个回调函数来处理每一行
    }
    fclose($handle);
}

// 使用示例：
// processLargeCsvFile('large_data.csv', function($row) {
//     // 这里可以对 $row 进行数据库插入、计算、日志记录等操作
//     // 确保每次处理完一行，相关的内存占用都能被释放
//     echo "处理行: " . implode(', ', $row) . "\n";
// });

通过这种方式，$data数组就不会无限增长，从而避免了内存溢出。

PHP生成器（Generators）：对于PHP 5.5及更高版本，生成器是一个非常优雅的解决方案。它允许你编写一个函数，像迭代器一样逐个生成值，而不是一次性返回一个完整的数组。这在处理大型数据集时，能够显著减少内存占用。

<?php
function getCsvRowsGenerator(string $filePath, string $delimiter = ',', string $enclosure = '"'): Generator
{
    if (!file_exists($filePath)) {
        throw new Exception("CSV文件不存在: " . $filePath);
    }

    $handle = fopen($filePath, 'r');
    if ($handle === false) {
        throw new Exception("无法打开CSV文件进行读取: " . $filePath);
    }

    while (($row = fgetcsv($handle, 0, $delimiter, $enclosure)) !== false) {
        yield $row; // 每次循环，yield一个行数据
    }

    fclose($handle);
}

// 使用生成器处理大型CSV文件
// try {
//     foreach (getCsvRowsGenerator('large_data.csv') as $rowIndex => $row) {
//         // 每次循环只加载一行数据到内存
//         // 可以在这里进行数据库插入、数据转换等操作
//         // echo "处理行 " . ($rowIndex + 1) . ": " . implode(' | ', $row) . "\n";
//     }
// } catch (Exception $e) {
//     echo "读取CSV文件时发生错误: " . $e->getMessage() . "\n";
// }
?>

生成器让代码看起来更简洁，同时保持了内存效率。

unset()变量：如果你在循环内部创建了临时变量，并且这些变量可能会占用较大内存，处理完后及时unset()它们是一个好习惯。虽然PHP的垃圾回收机制会处理，但手动unset()可以更早地释放内存。
调整PHP的memory_limit：这更像是一个“治标不治本”的方案，但有时也是必要的。在php.ini中或者在脚本开头使用ini_set('memory_limit', '512M');来增加PHP脚本可用的内存上限。不过，这不能解决根本问题，如果文件真的非常大，你最终还是会遇到限制。我个人觉得，优化代码结构才是王道，调整memory_limit只是一个辅助手段。

批量处理（Batch Processing）：如果你需要将CSV数据导入数据库，不要每读取一行就执行一次数据库插入。这会导致大量的数据库连接和I/O操作，效率极低。更好的做法是，每读取N行数据（例如1000行），就批量执行一次数据库插入。这样可以显著提高性能。

// 简单的批量插入示例
// $batchSize = 1000;
// $batch = [];
// foreach (getCsvRowsGenerator('large_data.csv') as $row) {
//     $batch[] = $row;
//     if (count($batch) >= $batchSize) {
//         // 执行批量数据库插入操作
//         // insertIntoDatabase($batch);
//         $batch = []; // 清空批次
//     }
// }
// if (!empty($batch)) {
//     // 处理剩余的批次
//     // insertIntoDatabase($batch);
// }

综合来看，fgetcsv()配合逐行处理或生成器，是PHP处理大型CSV文件最有效且内存友好的方法。避免一次性加载所有数据，是防止内存溢出的金科玉律。

本篇关于《PHP读取CSV文件的实用方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！