php fgets() 函數從檔案指標中讀取一行。
它的文法是:
fgets(file,length)
| 參數 |
描述 |
| file |
必需。規定要讀取的檔案。 |
| length |
可選。規定要讀取的位元組數。預設是 1024 位元組。 |
從 file 指向的檔案中讀取一行並返回長度最多為 length - 1 位元組的字串。碰到分行符號(包括在傳回值中)、EOF 或者已經讀取了 length - 1 位元組後停止(要看先碰到那一種情況)。如果沒有指定 length,則預設為 1K,或者說 1024 位元組。
若失敗,則返回 false。
注釋:length 參數從 PHP 4.2.0 起成為可選項,如果忽略,則行的長度被假定為 1024 位元組。從 PHP 4.3 開始,忽略掉 length將繼續從流中讀取資料直到行結束。如果檔案中的大多數行都大於 8 KB,則在指令碼中指定最大行的長度在利用資源上更為有效。
注釋:從 PHP 4.3 開始本函數可以安全用於二進位檔案。早期的版本則不行。
注釋:如果碰到 PHP 在讀取檔案時不能識別 Macintosh 檔案的行結束符,可以啟用 auto_detect_line_endings 運行時配置選項。
下面我們舉個例子講述如何一行行讀取一個檔案。
假設我們有一個 sites.txt 檔案,該檔案有三行,內容如下:
woyouxian.comblabla.cngoogle.com
sites.txt 的檔案路徑是:
C:\blabla\php\sites.txt
我們用 PHP 一行行讀取檔案內容,PHP代碼如下:
<html><body><?php$f= fopen("C:\\blabla\\php\\sites.txt","r");while (!feof($f)){ $line = fgets($f); echo "site: ",$line,"<br />";}fclose($f);?></body></html>
執行該 PHP 檔案,返回的顯示結果是:
site: woyouxian.comsite: blabla.cnsite: google.com
該 PHP 代碼的第一行是開啟檔案,最後一行是關閉一個檔案。當中的 while 迴圈語句表示,當檔案沒有結束,就讀取一行,迴圈執行,直到檔案指標到文章末尾為止。
feof 函數是PHP 的一個內建函數,用來測試檔案指標是否已經到了檔案末尾。如果是返回 TRUE,如果不是,返回 FALSE。eof 的英文意思就是 end of file,很容易記。
正常情況下,fgets 函數的傳回值是一個字串,如果出錯,返回 FALSE。