php fgetcsv PHP fgetcsv() 函数

php fgetcsv

PHP fgetcsv 函数用于从文件指针中读取 CSV 内容，并将其解析到一个数组中。它是 PHP 中最常用的 CSV 解析函数，可以让你快速地读取和处理 CSV 文件。

fgetcsv() 函数的语法如下所示：

array fgetcsv ( resource $handle [, int $length = 0 [, string $delimiter = ',' [, string $enclosure = '"' [, string $escape = '\\' ]]]] )

其中，参数 handle 是必需的，它是包含 CSV 数据的文件指针。length 参数用于指定一行最大字符数；delimiter 参数用于指定字段分隔符；enclosure 参数用于指定字段引用符号；escape 参数用于指定转义字符。

fgetcsv() 函数返回一个包含 CSV 数据的一维数组。如果失败则返回 FALSE。下面是一个使用 fgetcsv() 读取 CSV 文件的例子：

$row = 1;  // 表格行序号 
if (($handle = fopen("test.csv", "r")) !== FALSE) {  // 打开文件 
    while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {  // 读取文件内容 
        $num = count($data);  // 表格列序号 

        echo "
 $row: 
\n";

        for ($c=0; $c < $num; $c++) {  // 遍历表格内容 

            echo "$data[$c]\t";

        }

        echo "\n";

        $row++;

    }

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

PHP fgetcsv() 函数

PHP fgetcsv() 函数

---

完整的 PHP Filesystem 参考手册

---

定义和用法

fgetcsv() 函数从打开的文件中解析一行，校验 CSV 字段。

fgetcsv() 函数会在到达指定长度或读到文件末尾（EOF）时（以先到者为准），停止返回一个新行。

该函数如果成功则以数组形式返回 CSV 字段，如果失败或者到达文件末尾（EOF）则返回 FALSE。

语法

fgetcsv(file,length,separator,enclosure)

参数	描述
file	必需。规定要检查的文件。
length	可选。规定行的最大长度。必须大于 CSV 文件内最长的一行。如果忽略该参数（或者设置为 0），那么行长度就没有限制，不过可能会影响执行效率。 注意：该参数在 PHP 5 之前的版本是必需的。
separator	可选。设置字段分界符（只允许一个字符），默认值为逗号（ , ）。
enclosure	可选。设置字段环绕符（只允许一个字符），默认值为双引号（ " ）。

---

提示和注释

提示：请参阅 fputcsv() 函数。

---

实例 1

<?php
$file = fopen("contacts.csv","r");
print_r(fgetcsv($file));
fclose($file);
?>

CSV 文件：

Kai Jim, Refsnes, Stavanger, Norway
Hege, Refsnes, Stavanger, Norway

以上的代码将输出：

Array
(
[0] => Kai Jim
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)

---

实例 2

<?php
$file = fopen("contacts.csv","r");

while(! feof($file))
{
print_r(fgetcsv($file));
}

fclose($file);
?>

CSV 文件：

Kai Jim, Refsnes, Stavanger, Norway
Hege, Refsnes, Stavanger, Norway

以上的代码将输出：

Array
(
[0] => Kai Jim
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)
Array
(
[0] => Hege
[1] => Refsnes
[2] => Stavanger
[3] => Norway
)

---

完整的 PHP Filesystem 参考手册