PHP fgetcsv 文件系统函数

• 

  定义和用法

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

  版本支持

  PHP4	PHP5	PHP7
  支持	支持	支持

  5.3.0 增加了 escape 参数。

  4.3.5 现在起 fgetcsv() 的操作是二进制安全的。

  4.3.0 增加了 enclosure 参数。

• 

  语法

  fgetcsv (  resource $handle [, int $length = 0 [, string $delimiter = ',' [, string $enclosure = '"' [, string $escape = '\\' ]]]]  )   
  

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

  参数

  参数	必需的	描述
  handle	是	一个由 fopen()、popen() 或 fsockopen() 产生的有效文件指针。
  length	否	必须大于 CVS 文件内最长的一行。在 PHP 5 中该参数是可选的。如果忽略（在 PHP 5.0.4 以后的版本中设为 0）该参数的话，那么长度就没有限制，不过可能会影响执行效率。
  delimiter	否	设置字段分界符（只允许一个字符）。
  enclosure	否	设置字段环绕符（只允许一个字符）。
  escape	否	设置转义字符（只允许一个字符），默认是一个反斜杠。

• 

  返回值

  返回包含读取字段的索引数组。

  如果提供了无效的文件指针，fgetcsv() 会返回 NULL。 其他错误，包括碰到文件结束时返回 FALSE，。

• 

  示例

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

• 

  相关函数

  str_getcsv() - 解析 CSV 字符串为一个数组

  explode() - 使用一个字符串分割另一个字符串

  file() - 把整个文件读入一个数组中

  pack() - 将数据打包成二进制字符串

  fputcsv() - 将行格式化为 CSV 并写入文件指针