PHP fgetcsv() 函数
❮ PHP 文件系统参考手册实例
从打开的 CSV 文件中读取并输出一行:
<?php
$file = fopen("contacts.csv","r");
print_r(fgetcsv($file));
fclose($file);
?>
运行实例 »
定义和用法
fgetcsv() 函数从文件指针中读入一行并解析 CSV 字段。
与 fgets() 类似，不同的是 fgetcsv() 解析读入的行并找出 CSV 格式的字段，然后返回一个包含这些字段的数组。
fgetcsv() 出错时返回 FALSE，包括碰到文件结束时。
注释:从 PHP 4.3.5 起，fgetcsv() 的操作是二进制安全的。
提示: 另请参阅 fputcsv() 函数。
语法
fgetcsv(file, length, separator, enclosure)
参数值
| 参数 | 描述 |
|---|---|
| file | 必需。规定要检查的文件。 |
| length |
可选。规定行的最大长度。必须大于 CVS 文件内最长的一行。 在 PHP 5 中该参数是可选的。在 PHP 5 之前是必需的。 如果忽略（在 PHP 5.0.4 以后的版本中设为 0）该参数的话，那么长度就没有限制，不过可能会影响执行效率。 |
| separator | 可选。设置字段分界符（只允许一个字符），默认值为逗号。 |
| enclosure |
可选。设置字段环绕符（只允许一个字符），默认值为双引号。 该参数是在 PHP 4.3.0 中添加的。 |
| escape | 可选。指定转义字符。 默认为 "\\" |
提示和注释
注释:CSV 文件中的空行将被返回为一个包含有单个 null 字段的数组，不会被当成错误。
注释:该函数对区域设置是敏感的。比如说 LANG 设为 en_US.UTF-8 的话，单字节编码的文件就会出现读取错误。
注释:如果碰到 PHP 在读取文件时不能识别 Macintosh 文件的行结束符，可以激活 auto_detect_line_endings 运行时配置选项。
技术细节
| 返回值: | 一个包含 CSV 字段的数组，如果提供了无效的 file，则为 NULL，其他错误和 EOF | 为 FALSE
|---|---|
| PHP 版本: | 4.0+ |
| Binary Safe: | Yes, in PHP 4.3.5 |
| PHP 更新日志: | PHP 5.3 - 添加了escape参数 |
更多实例
实例
读取并输出 CSV 文件的全部内容:
<?php
$file = fopen("contacts.csv","r");
while(! feof($file))
{
print_r(fgetcsv($file));
}
fclose($file);
?>
运行实例 »
❮ PHP 文件系统参考手册
