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 运行时配置选项。

---

技术细节

为 FALSE

返回值:	一个包含 CSV 字段的数组，如果提供了无效的 file，则为 NULL，其他错误和 EOF
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 文件系统参考手册