您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP feof() 函數行為深度測試與正確讀取檔案的最佳實踐

編輯：PHP 相關知識

PHP feof() 函數行為深度測試與正確讀取檔案的最佳實踐

feof() 是 PHP 檔案操作中常用的「檢測檔案結束」函數，但其行為常被誤解，導致迴圈多跑一次或漏讀資料。本文透過實測代碼揭示 feof() 的真實運作機制，並提供兩種正確的檔案讀取模式。

測試環境

OS: Mac OS X 10.8.4
PHP: 5.3.15
測試檔案：7bytesfile 內容為 abcdefg (7 位元組)

實測代碼與關鍵發現

<?php
$filename = './7bytesfile';
$handle = fopen($filename, 'r');

for ($i = 0; $i <= filesize($filename); $i++) {
    fseek($handle, $i);
    echo "位置 " . ftell($handle) . "：";
    echo "fseek 後未讀取，feof=" . (feof($handle) ? 'TRUE' : 'FALSE') . " ";
    echo "字元：" . fgetc($handle) . " ";
    echo "讀取後，feof=" . (feof($handle) ? 'TRUE' : 'FALSE') . "<br>";
}

/* 測試結果關鍵發現：
1. fseek 移動指標到檔案末尾 (位置 7) 後，feof() 仍回傳 FALSE
2. 必須執行一次「讀取操作」(fgetc/fgets/fread) 後，feof() 才會回傳 TRUE
3. 這表示 feof() 不是檢查指標位置，而是根據「上次讀取結果」設定內部旗標
*/
?>

feof() 運作機制解析

PHP 內部維護一個「EOF 旗標」：

fseek()、rewind() 會將旗標重設為 FALSE
只有「讀取函數」在嘗試讀取超過檔案末尾時，才將旗標設為 TRUE
feof() 僅回傳此旗標值

這解釋為何「指標已在末尾」但 feof() 仍為 FALSE —— 因為尚未嘗試讀取。

錯誤示範：經典的 feof() 迴圈陷阱

<?php
$handle = fopen($filename, 'r');
while (!feof($handle)) {
    $char = fgetc($handle);
    echo $char; // 會多輸出一個空字元或 FALSE
}
fclose($handle);
/* 結果：正常輸出 abcdefg 後，迴圈多跑一次
   原因：讀取 'g' 後指標在末尾，feof() 仍 FALSE，再執行一次 fgetc() 才觸發 EOF
*/
?>

正確讀取模式一：直接檢查讀取函數回傳值（推薦）

<?php
$handle = fopen($filename, 'r');
while (($content = fgets($handle)) !== FALSE) {
    // 處理 $content
    echo $content;
}
fclose($handle);
/* 優點：
   - 單一判斷條件，邏輯清晰
   - 必須使用 !== FALSE 避免「內容為 0 或空字串」被誤判為結束
   - 效能略優於 feof() 迴圈
*/
?>

正確讀取模式二：先讀後判斷 feof()

<?php
$handle = fopen($filename, 'r');
$content = fgets($handle); // 先讀第一筆
while (!feof($handle)) {
    // 處理 $content
    echo $content;
    $content = fgets($handle); // 迴圈末尾讀取下一筆
}
fclose($handle);
/* 優點：邏輯符合直覺「讀完才知道有沒有下一筆」
   缺點：程式碼重複，需維護兩處讀取呼叫
*/
?>