异常教程

PHP fgetcsv() 函数（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在数据处理领域，CSV（Comma-Separated Values）文件因其简洁性和通用性，成为存储和交换结构化数据的重要格式。PHP 作为 Web 开发的主流语言之一，提供了丰富的文件操作函数。其中，fgetcsv() 函数是 PHP 处理 CSV 文件的核心工具。无论是导入用户数据、解析日志文件，还是分析市场报告，fgetcsv() 都能帮助开发者高效完成任务。本文将从基础用法到进阶技巧，结合实例和形象比喻，带读者全面掌握这一函数的使用方法。

基础用法：像读取 Excel 表格一样解析 CSV

CSV 文件的结构与特点

CSV 文件以纯文本形式存储数据，每一行代表一条记录，各字段通过逗号分隔。例如：

姓名,年龄,城市
张三,25,北京
李四,30,上海
王五,28,广州

这种结构类似于 Excel 表格，但无需依赖特定软件即可编辑和共享。

fgetcsv() 函数的核心作用

fgetcsv() 的作用是从 CSV 文件中逐行读取数据，并将其转换为 PHP 数组。其基本语法为：

array fgetcsv ( resource $handle [, int $length = 0 [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\\" ]]]] )
  • $handle：文件句柄，通常通过 fopen() 获取。
  • $length：每行读取的最大长度（默认为 0，即读取整行）。
  • $delimiter：字段分隔符，默认为逗号。
  • $enclosure：字段包围符，默认为双引号。
  • $escape：转义字符，默认为反斜杠。

示例：读取基础 CSV 文件

// 打开 CSV 文件  
$handle = fopen('data.csv', 'r');  

// 循环读取每一行  
while (($row = fgetcsv($handle)) !== false) {  
    // 输出当前行数据  
    print_r($row);  
}  

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

执行后，$row 将依次存储每一行的字段值，例如：

Array  
(  
    [0] => 姓名  
    [1] => 年龄  
    [2] => 城市  
)  
Array  
(  
    [0] => 张三  
    [1] => 25  
    [2] => 北京  
)

参数详解与进阶用法

参数 length：控制读取范围

$length 参数用于限制每行读取的最大字节数。例如，若 CSV 文件中某行数据异常长，可设置 1024 限制读取：

$row = fgetcsv($handle, 1024);

但需注意：若设置值过小，可能导致数据截断，需根据实际需求调整。

参数 delimiter：自定义分隔符

当 CSV 文件使用非逗号分隔符（如制表符 "\t"）时，需通过 $delimiter 参数指定：

// 处理制表符分隔的 CSV  
$row = fgetcsv($handle, 0, "\t");

比喻：这就像告诉函数“不要用逗号当标点，改用句号来分隔句子”。

参数 enclosure：处理特殊字符与引号

CSV 文件中若字段包含逗号，通常会用引号包裹以避免误判。例如：

姓名,年龄,城市  
"王小明, Jr.",25,深圳

此时，fgetcsv() 默认通过 $enclosure 参数（双引号）识别字段边界，自动将 "王小明, Jr." 解析为一个完整字段。

参数 escape：转义特殊符号

若字段内容本身包含引号或分隔符，可通过 $escape 参数转义。例如：

// 使用反斜杠转义引号  
$row = fgetcsv($handle, 0, ',', '"', '\\');

此时，"He said \"Hello\"" 将被解析为一个字段。

常见问题与解决方案

问题 1：CSV 文件包含 BOM 头导致乱码

某些编辑器（如 Notepad++）在保存 CSV 文件时会添加字节顺序标记（BOM），导致第一行出现  等乱码。解决方法：

// 读取并丢弃 BOM  
$handle = fopen('data.csv', 'r');  
fgetcsv($handle, 0, ',', '"', '\\'); // 丢弃第一行

或在打开文件时先读取并检查：

if (substr($data = fread($handle, 3), 0, 3) == "\xEF\xBB\xBF") {  
    rewind($handle); // 重置指针  
}

问题 2：空行或无效数据的处理

CSV 文件中可能包含空行或格式错误的行，需通过条件判断过滤：

while (($row = fgetcsv($handle)) !== false) {  
    if (empty($row)) {  
        continue; // 跳过空行  
    }  
    // 处理有效数据  
}

问题 3：字段数量不一致的兼容性

若某行字段数量与标题行不一致，可通过 array_pad() 补齐缺失字段：

$title = ['姓名', '年龄', '城市'];  
$min_fields = count($title);  
while (($row = fgetcsv($handle)) !== false) {  
    $row = array_pad($row, $min_fields, null); // 缺失字段用 null 填充  
    // 继续处理  
}

进阶技巧：结合其他函数提升效率

技巧 1：关联数组与标题行

通过标题行将字段名与数据关联，使代码更易读：

// 读取标题行  
$header = fgetcsv($handle);  

while (($row = fgetcsv($handle)) !== false) {  
    $data = array_combine($header, $row); // 合并为关联数组  
    echo "姓名：{$data['姓名']}，年龄：{$data['年龄']}";  
}

技巧 2：处理大数据量 CSV

对于超大 CSV 文件，避免一次性加载所有数据，改用逐行处理：

// 示例：统计年龄总和  
$total_age = 0;  
while (($row = fgetcsv($handle)) !== false) {  
    if (isset($row[1])) {  
        $total_age += (int) $row[1];  
    }  
}  
echo "总年龄：$total_age";

技巧 3：结合 fputcsv() 写入数据

fputcsv() 可将数组转换为 CSV 格式并写入文件：

// 写入新行  
fputcsv($output_handle, ['李四', 30, '上海']);

实战案例：从 CSV 导入用户数据到数据库

案例需求

假设需将 CSV 文件中的用户数据（姓名、邮箱、注册时间）导入 MySQL 数据库。

步骤 1：读取并验证数据

$handle = fopen('users.csv', 'r');  
$header = fgetcsv($handle); // 获取标题行  

// 验证标题是否符合预期  
if ($header !== ['姓名', '邮箱', '注册时间']) {  
    die('CSV 格式错误');  
}  

// 连接数据库  
$conn = mysqli_connect('localhost', 'user', 'pass', 'test');  

// 逐行插入数据  
while (($row = fgetcsv($handle)) !== false) {  
    $name = mysqli_real_escape_string($conn, $row[0]);  
    $email = mysqli_real_escape_string($conn, $row[1]);  
    $time = date('Y-m-d H:i:s', strtotime($row[2]));  

    $sql = "INSERT INTO users (name, email, register_time) VALUES ('$name', '$email', '$time')";  
    mysqli_query($conn, $sql);  
}  

fclose($handle);  
mysqli_close($conn);

步骤 2：处理异常与错误

  • 文件不存在：在 fopen() 前检查文件路径。
  • 数据库连接失败：使用 mysqli_connect_error() 捕获错误。
  • 数据格式错误：例如，邮箱格式无效时跳过该行： 
    if (!filter_var($row[1], FILTER_VALIDATE_EMAIL)) {  
    continue;  
}

结论

PHP fgetcsv() 函数 是处理 CSV 文件不可或缺的工具，其灵活性和强大功能能覆盖从简单数据读取到复杂数据处理的多种场景。通过本文的讲解，读者应能掌握以下核心能力：

  1. 使用 fgetcsv() 读取并解析基础 CSV 文件
  2. 理解并调整函数参数以适应不同分隔符和特殊字符
  3. 结合其他函数（如 fputcsv()、array_combine()）提升数据处理效率
  4. 处理常见问题并设计健壮的数据导入流程

无论是导入用户数据、分析日志，还是与其他系统交换数据，fgetcsv() 都能成为开发者高效解决问题的得力助手。建议读者通过实际项目练习，逐步掌握这一函数的全部潜力。

最新发布

查看更多文章