PHP fgetcsv() 函数

定义和用法

fgetcsv() 函数从文件指针中读入一行并解析 CSV 字段。

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

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

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

语法

  1. fgetcsv(file,length,separator,enclosure)
参数 描述
file 必需。规定要检查的文件。
length 可选。规定行的最大长度。必须大于 CVS 文件内最长的一行。 在 PHP 5 中该参数是可选的。在 PHP 5 之前是必需的。 如果忽略(在 PHP 5.0.4 以后的版本中设为 0)该参数的话,那么长度就没有限制,不过可能会影响执行效率。
separator 可选。设置字段分界符(只允许一个字符),默认值为逗号。
enclosure 可选。设置字段环绕符(只允许一个字符),默认值为双引号。 该参数是在 PHP 4.3.0 中添加的。

提示和注释

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

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

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

例子

例子 1

  1. <?php
  2.  
  3. $file = fopen("contacts.csv","r");
  4. print_r(fgetcsv($file));
  5. fclose($file);
  6.  
  7. ?>

CSV 文件:

  1. George, John, Thomas, USA
  2. James, Adrew, Martin, USA

输出类似:

  1. Array
  2. (
  3. [0] => George
  4. [1] => John
  5. [2] => Thomas
  6. [3] => USA
  7. )

例子 2

  1. <?php
  2.  
  3. $file = fopen("contacts.csv","r");
  4.  
  5. while(! feof($file))
  6. {
  7. print_r(fgetcsv($file));
  8. }
  9.  
  10. fclose($file);
  11.  
  12. ?>

CSV 文件:

  1. George, John, Thomas, USA
  2. James, Adrew, Martin, USA

输出类似:

  1. Array
  2. (
  3. [0] => George
  4. [1] => John
  5. [2] => Thomas
  6. [3] => USA
  7.  
  8. Array
  9. (
  10. [0] => James
  11. [1] => Adrew
  12. [2] => Martin
  13. [3] => USA
  14. )