PHP file_exists 與 is_file 判斷文件存在的區別詳解

函數對比

代碼示例

<?php
$file = '新建 文本 文檔.txt'; // 含空格文件名
$file1 = 'a.txt';

// 正確處理含空格文件名
$path = 'uploads/' . $file;

if (is_file($path)) {
    echo "文件存在且是常規文件";
} elseif (file_exists($path)) {
    echo "路徑存在但非常規文件(可能是目錄)";
} else {
    echo "文件不存在";
}

// 批量檢查
$files = ['a.txt', 'b.txt', 'dir/'];
foreach ($files as $f) {
    echo "$f: " . (is_file($f) ? '文件' : (file_exists($f) ? '目錄/其他' : '不存在')) . "\n";
}
?>

常見坑點

1. 緩存機制導致誤判

<?php
// 文件被其他進程刪除後，PHP 可能仍返回 true
clearstatcache(); // 清除狀態緩存
if (file_exists($file)) { ... }
?>

2. 相對路徑問題

<?php
// 錯誤：相對路徑依賴當前工作目錄
if (file_exists('config.php')) { ... }

// 正確：使用絕對路徑
if (file_exists(__DIR__ . '/config.php')) { ... }
?>

3. open_basedir 限制

若路徑超出 open_basedir 範圍，兩函數均返回 false 並拋出警告。

最佳實踐

• 只判斷文件：優先用 is_file()，語義明確且快
• 判斷目錄：用 is_dir()
• 存在即可：用 file_exists()
• 高併發場景：配合 clearstatcache(true, $path) (PHP 5.3+)
• 文件上傳驗證：is_uploaded_file($_FILES['file']['tmp_name']) 專門判斷上傳文件

進階：SplFileInfo 物件導向方式

$fileInfo = new SplFileInfo('/path/to/file.txt');
if ($fileInfo->isFile()) { ... }
if ($fileInfo->isDir()) { ... }
echo $fileInfo->getSize() . ' bytes';
echo $fileInfo->getMTime(); // 修改時間戳