fgetcsv

說明

array fgetcsv ( int handle [, int length [, string delimiter [, string enclosure]]] )

handle: 一個由 fopen()、popen() 或 fsockopen() 產生的有效檔案指標。
length （可選）: 必須大於 CVS 檔案內最長的一行。在 PHP 5 中該參數是可選的。若果忽略（在 PHP 5.0.4 以後的版本中設為 0）該參數的話，那麼長度就沒有限制，不過可能會影響執行效率。
delimiter （可選）: 設定欄位分界符（只容許一個字元），預設值為逗號。
enclosure （可選）: 設定欄位環繞符（只容許一個字元），預設值為雙引號。該參數是在 PHP 4.3.0 中增加的。

和 fgets() 類似，只除了 fgetcsv() 解析讀入的行並找出 CSV 格式的欄位然後返回一個包括這些欄位的陣列。

fgetcsv() 出錯時返回 FALSE，內含碰到檔案結束時。

注: CSV 檔案中的空行將被返回為一個包括有單個 null 欄位的陣列，不會被當成錯誤。

例子 1. 讀取並顯示 CSV 檔案的整個內容
<?php $row = 1; $handle = fopen("test.csv","r"); while ($data = fgetcsv($handle, 1000, ",")) { $num = count($data); echo "<p> $num fields in line $row: <br>\n"; $row++; for ($c=0; $c < $num; $c++) { echo $data[$c] . "<br>\n"; } } fclose($handle); ?>

從 PHP 4.3.5 起，fgetcsv() 的動作是二進位安全的。

注: 該函數對區功能變數設定是敏感的。比如說 LANG 設為 en_US.UTF-8 的話，單位元組編碼的檔案就會出現讀取錯誤。

注: 若果碰到 PHP 在讀取檔案時不能識別 Macintosh 檔案的行結束符，可以啟動 auto_detect_line_endings 運行時配置選項。

參見 explode()，file()，pack() 和 fputcsv()