| 函數 | 檢測目標 | 返回 true 條件 |
|---|---|---|
| file_exists() | 文件 或 目錄 | 路徑存在(文件/目錄/符號鏈接) |
| is_file() | 僅文件 | 路徑存在且為普通文件 |
| is_dir() | 僅目錄 | 路徑存在且為目錄 |
結論: file_exists = is_file OR is_dir,但性能差異巨大。
| 場景 | is_file | file_exists | is_dir |
|---|---|---|---|
| 文件存在(當前目錄) | 0.457 | 2.064 | - |
| 文件存在(3層路徑) | 0.491 | 3.350 | - |
| 文件存在(5層路徑) | 0.496 | 4.210 | - |
| 文件不存在(當前目錄) | 2.017 | 1.985 | - |
| 文件不存在(5層路徑) | 4.191 | 4.150 | - |
| 目錄存在 | - | 2.927 | 0.460 |
| 目錄不存在 | - | 2.972 | 2.936 |
所有函數結果均被緩存(clearstatcache() 可清除)。file_exists 內部需依次嘗試文件/目錄屬性檢查,而專用函數直接針對性查詢 inode 屬性。
需要檢測路徑
│
├─ 確定是文件 → is_file() ✅
│
├─ 確定是目錄 → is_dir() ✅
│
└─ 不確定類型 → file_exists() ⚠️
(或先 is_file 再 is_dir)
$path = '/var/www/html'; // 目錄
is_file($path); // false
file_exists($path); // true
// 符號鏈接
symlink('/real/file', '/link/file');
is_file('/link/file'); // true(跟隨鏈接)
is_link('/link/file'); // true
file_exists('/link/file'); // true
glob() 或 scandir() 一次讀取目錄條目clearstatcache(true, $path)(PHP 5.3+ 支持指定路徑)@ 或設錯誤處理器「用對函數,性能翻倍」:確定查文件用 is_file,確定查目錄用 is_dir,只有真不確定類型才用 file_exists。這是 PHP 文件系統操作中最高性價比的優化點。