fgetcsv

(PHP 4, PHP 5)

fgetcsv — 从文件指针中读入一行并解析 CSV 字段

说明

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，包括碰到文件结束时。

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

Example#1 读取并显示 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() 的操作是二进制安全的。

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

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

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


	PHP5中文手册 fgetc fgets Filesystem PHP Manual fgetcsv (PHP 4, PHP 5) fgetcsv — 从文件指针中读入一行并解析 CSV 字段说明 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`，包括碰到文件结束时。 Note: CSV 文件中的空行将被返回为一个包含有单个 null 字段的数组，不会被当成错误。 Example#1 读取并显示 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() 的操作是二进制安全的。 Note: 该函数对区域设置是敏感的。比如说 `LANG` 设为 en_US.UTF-8 的话，单字节编码的文件就会出现读取错误。 Note: 如果碰到 PHP 在读取文件时不能识别 Macintosh 文件的行结束符，可以激活 auto_detect_line_endings 运行时配置选项。参见 explode()，file()，pack() 和 fputcsv() fgetc fgets Filesystem PHP Manual