使用php fgetcsv处理CSV文件，注意这几点避免踩坑。

发布日期： 2025-09-22 阅读量： 作者： admin

今天搞了一下PHP读CSV文件

最近手头有个活儿，需要处理一批数据，格式是CSV的。以前也零星弄过，但没正经记下来。今天正好又碰到了，就想着干脆彻底搞明白，顺便记录一下过程。

任务不复杂，就是把一个CSV文件里的数据读出来，然后存到数据库里去。CSV文件嘛说白了就是逗号分隔值的文本文件，用记事本都能打开看。

PHP里处理这个，我第一个想到的就是 `fgetcsv` 这个函数。看名字就知道，`f` 开头，估计是文件操作相关的，`get` 是获取，`csv` 就是目标格式。八九不离十了。

开搞：

第一步，得先把文件打开。这个简单，用 `fopen` 就行，指定文件名和打开模式。我这里是只读，所以用的模式是 'r'。

php

$handle = fopen("我的数据.csv", "r");

文件打开了，拿到一个句柄 `$handle`，接下来就轮到 `fgetcsv` 上场了。这玩意儿是一行一行读的。很自然就想到了用 `while` 循环。

php

while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {

// 处理 $data 数组

解释一下这行代码里的参数：

第一个参数 `$handle` 就是刚才 `fopen` 返回的文件句柄。
第二个参数 `1000` 是指定每次读取行的最大长度。这个值得比你CSV文件里最长的那一行还要长才行，不然数据可能会被截断。我这里先随便写了个1000，实际用的时候得根据情况调整，或者干脆设成0，让它自己判断。
第三个参数 `","` 是指定用什么符号分隔字段的。CSV嘛默认就是逗号，所以这里写逗号。

每次循环，`fgetcsv` 就会从文件里读一行，并把这行数据按逗号拆分成一个数组，赋值给 `$data`。如果读到了文件末尾，或者出错了，它会返回 `FALSE`，循环就停了。

遇到的小麻烦：

本来以为挺顺利，结果一跑，发现读出来的中文全是乱码。又是编码问题，老朋友了。

检查了一下我的CSV文件，是用Excel导出的，默认编码好像是GBK或者GB2312之类的。而PHP脚本我习惯用UTF-8。编码不一致，不乱才怪。

咋解决？试了几种方法：

一开始想在 `fopen` 之后加个 `setlocale` 设置区域信息，好像有点用，但有时候又不灵。

php

// 试过这个，但效果不理想

// setlocale(LC_ALL, 'zh_*');

后来发现一个更直接的办法，就是在读出数据 `$data` 之后，对数组里的每个元素进行编码转换。用 `mb_convert_encoding` 函数挺方便。

php

while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {

$processed_data = [];

foreach ($data as $item) {

// 从 GBK 转到 UTF-8

$processed_data[] = mb_convert_encoding($item, 'UTF-8', 'GBK');

// 现在用 $processed_data 这个数组就没乱码了

// 后面该干嘛干嘛比如入库

var_dump($processed_data);

这样处理了一下，乱码问题就解决了。前提是你得知道你的CSV文件是什么编码，然后指定对就行。`mb_convert_encoding` 第二个参数是目标编码（我的是UTF-8），第三个参数是原始编码（我猜是GBK，试了下果然是）。

收尾：

数据读出来，编码也对了，剩下的就是业务逻辑了，该插入数据库的插入数据库，该干啥的干别忘了用 `fclose($handle)` 把打开的文件关掉，好习惯。

`fgetcsv` 用起来还是挺直接的，就是要注意文件编码这个老大难问题。搞定了编码，基本就没啥坑了。这回实践下来，感觉对CSV文件处理又熟悉了一点，下次再碰到类似需求，心里就有底了。