fgetcsv

从文件指针中读入一行并解析 CSV 字段 (PHP 3 >= 3.0.8, PHP 4, PHP 5)
array fgetcsv ( int handle [, int length [, string delimiter [, string enclosure]]] )

说明

handle
一个由 fopen()popen()fsockopen() 产生的有效文件指针。
length (可选)
必须大于 CVS 文件内最长的一行。在 PHP 5 中该参数是可选的。如果忽略(在 PHP 5.0.4 以后的版本中设为 0)该参数的话,那么长度就没有限制,不过可能会影响执行效率。
delimiter (可选)
设置字段分界符(只允许一个字符),默认值为逗号。
enclosure (可选)
设置字段环绕符(只允许一个字符),默认值为双引号。该参数是在 PHP 4.3.0 中添加的。

fgets() 类似,只除了 fgetcsv() 解析读入的行并找出 CSV 格式的字段然后返回一个包含这些字段的数组。

fgetcsv() 出错时返回 FALSE,包括碰到文件结束时。

注意:

CSV 文件中的空行将被返回为一个包含有单个 null 字段的数组,不会被当成错误。

例 557. 读取并显示 CSV 文件的整个内容

<?php
$row
= 1;
$handle = fopen("test.csv","r");
while (
$data = fgetcsv($handle, 1000, ",")) {
   
$num = count($data);
   echo
"<p> $num fields in line $row: <br>\n";
   
$row++;
   for (
$c=0; $c < $num; $c++) {
       echo
$data[$c] . "<br>\n";
   }
}
fclose($handle);
?>

从 PHP 4.3.5 起,fgetcsv() 的操作是二进制安全的。

注意:

该函数对区域设置是敏感的。比如说 LANG 设为 en_US.UTF-8 的话,单字节编码的文件就会出现读取错误。

注意:

如果碰到 PHP 在读取文件时不能识别 Macintosh 文件的行结束符,可以激活 auto_detect_line_endings 运行时配置选项。

参见 explode()file()pack()fputcsv()