PHP is_file 與 file_exists 差異深度解析：緩存機制導致的陷阱

許多開發者以為 is_file() 可直接替代 file_exists()，實則不然。二者核心差異在於 **統計信息緩存**，可能導致文件狀態檢測失效。

問題複現實驗

<?php
$filename = 'test.txt';

// 確保文件存在
file_put_contents($filename, 'test');

// 第一次檢測
if (is_file($filename)) {
    echo "$filename exists!\n";
} else {
    echo "$filename no exists!\n";
}

// 10 秒內手動刪除文件
sleep(10);

// 第二次檢測
if (is_file($filename)) {
    echo "$filename exists!\n";
} else {
    echo "$filename no exists!\n";
}
?>

輸出結果與原因

test.txt exists!
test.txt exists!  ← 文件已刪除卻仍返回 true

原因： is_file() 內部調用 stat() 系統調用，PHP 會緩存文件統計信息（inode、修改時間、大小等）。同一腳本執行期間，對**同路徑**再次調用 is_file()、filesize()、filemtime() 等函數時，直接讀取緩存，**不再訪問磁盤**。

對比：file_exists() 無緩存

test.txt exists!
test.txt no exists!  ← 正確反映刪除狀態

file_exists() 每次調用都重新訪問文件系統，無緩存機制。

解決方案：clearstatcache()

// 在需要實時狀態前調用
clearstatcache(true, $filename); // PHP 5.3+ 支持針對特定路徑清除

if (is_file($filename)) { ... }

函數選擇指南

性能補充

• is_file() 緩存機制在**單進程請求**內有效，跨請求不共享
• 高併發場景下，文件系統本身有緩存，clearstatcache() 影響微乎其微
• 極致性能可用 spl_file_info 對象複用統計信息

記住：**需實時性時用 file_exists() 或手動清緩存**，別讓緩存成了 Bug 溫床。