(PHP 4, PHP 5, PHP 7, PHP 8)
fgetcsv — 從文件指針中讀入一行并解析 CSV 字段
$handle,$length = 0,$delimiter = ',',$enclosure = '"',$escape = '\\'和 fgets() 類(lèi)似，只除了 fgetcsv() 解析讀入的行并找出 CSV 格式的字段然后返回一個(gè)包含這些字段的數組。
handle一個(gè)由 fopen()、popen() 或 fsockopen() 產(chǎn)生的有效文件指針。
length必須大于 CVS 文件內最長(cháng)的一行。在 PHP 5 中該參數是可選的。如果忽略（在 PHP 5.0.4 以后的版本中設為 0）該參數的話(huà)，那么長(cháng)度就沒(méi)有限制，不過(guò)可能會(huì )影響執行效率。
delimiter設置字段分界符（只允許一個(gè)字符）。
enclosure設置字段環(huán)繞符（只允許一個(gè)字符）。
escape設置轉義字符（只允許一個(gè)字符），默認是一個(gè)反斜杠。
返回包含讀取字段的索引數組。
注意:
CSV 文件中的空行將被返回為一個(gè)包含有單個(gè) null 字段的數組，不會(huì )被當成錯誤。
注意: 在讀取在 Macintosh 電腦中或由其創(chuàng )建的文件時(shí)， 如果 PHP 不能正確的識別行結束符，啟用運行時(shí)配置可選項 auto_detect_line_endings 也許可以解決此問(wèn)題。
如果提供了無(wú)效的文件指針，fgetcsv() 會(huì )返回 null。
其他錯誤，包括碰到文件結束時(shí)返回 false，。
| 版本 | 說(shuō)明 |
|---|---|
| 5.3.0 |
增加了 escape 參數。
|
| 4.3.5 | 現在起 fgetcsv() 的操作是二進(jìn)制安全的。 |
| 4.3.0 |
增加了 enclosure 參數。
|
示例 #1 讀取并顯示 CSV 文件的整個(gè)內容
<?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);
}
?>
注意:
該函數對區域設置是敏感的。比如說(shuō) LANG 設為
en_US.UTF-8的話(huà)，單字節編碼的文件就會(huì )出現讀取錯誤。