定義和用法

fgetcsv() 函數(shù)從文件指針中讀入一行并解析 CSV 字段。

與 fgets() 類(lèi)似，不同的是 fgetcsv() 解析讀入的行并找出 CSV 格式的字段，然后返回一個(gè)包含這些字段的數(shù)組。

fgetcsv() 出錯(cuò)時(shí)返回 FALSE，包括碰到文件結(jié)束時(shí)。

注釋?zhuān)?/span>從 PHP 4.3.5 起，fgetcsv() 的操作是二進(jìn)制安全的。

語(yǔ)法

fgetcsv(file,length,separator,enclosure)

參數(shù)	描述
file	必需。規(guī)定要檢查的文件。
length	可選。規(guī)定行的最大長(zhǎng)度。必須大于 CVS 文件內(nèi)最長(zhǎng)的一行。 在 PHP 5 中該參數(shù)是可選的。在 PHP 5 之前是必需的。 如果忽略（在 PHP 5.0.4 以后的版本中設(shè)為 0）該參數(shù)的話，那么長(zhǎng)度就沒(méi)有限制，不過(guò)可能會(huì)影響執(zhí)行效率。
separator	可選。設(shè)置字段分界符（只允許一個(gè)字符），默認(rèn)值為逗號(hào)。
enclosure	可選。設(shè)置字段環(huán)繞符（只允許一個(gè)字符），默認(rèn)值為雙引號(hào)。 該參數(shù)是在 PHP 4.3.0 中添加的。

提示和注釋

注釋?zhuān)?/span>CSV 文件中的空行將被返回為一個(gè)包含有單個(gè) null 字段的數(shù)組，不會(huì)被當(dāng)成錯(cuò)誤。

注釋?zhuān)?/span>該函數(shù)對(duì)區(qū)域設(shè)置是敏感的。比如說(shuō) LANG 設(shè)為 en_US.UTF-8 的話，單字節(jié)編碼的文件就會(huì)出現(xiàn)讀取錯(cuò)誤。

注釋?zhuān)?/span>如果碰到 PHP 在讀取文件時(shí)不能識(shí)別 Macintosh 文件的行結(jié)束符，可以激活 auto_detect_line_endings 運(yùn)行時(shí)配置選項(xiàng)。

例子

例子 1

<?php

$file = fopen("contacts.csv","r");
print_r(fgetcsv($file));
fclose($file);

?>

CSV 文件：

George, John, Thomas, USA
James, Adrew, Martin, USA

輸出類(lèi)似：

Array 
( 
[0] => George
[1] => John 
[2] => Thomas
[3] => USA
)

例子 2

<?php

$file = fopen("contacts.csv","r");

while(! feof($file))
  {
  print_r(fgetcsv($file));
  }

fclose($file);

?> 

CSV 文件：

George, John, Thomas, USA
James, Adrew, Martin, USA

輸出類(lèi)似：

Array 
( 
[0] => George
[1] => John 
[2] => Thomas
[3] => USA

Array
(
[0] => James
[1] => Adrew
[2] => Martin
[3] => USA
)