file_exists

(PHP 4, PHP 5, PHP 7, PHP 8)

file_exists檢查文件或目錄是否存在

說明

file_exists(string $filename): bool

檢查文件或目錄是否存在。

參數(shù)

filename

文件或目錄的路徑。

在 Windows 中要用 //computername/share/filename 或者 \\computername\share\filename 來檢查網(wǎng)絡(luò)中的共享文件。

返回值

如果由 filename 指定的文件或目錄存在則返回 true,否則返回 false。

注意:

This function will return false for symlinks pointing to non-existing files.

注意:

The check is done using the real UID/GID instead of the effective one.

注意: 因為 PHP 的整數(shù)類型是有符號整型而且很多平臺使用 32 位整型,對 2GB 以上的文件,一些文件系統(tǒng)函數(shù)可能返回?zé)o法預(yù)期的結(jié)果。

范例

示例 #1 測試一個文件是否存在

<?php
$filename 
'/path/to/foo.txt';

if (
file_exists($filename)) {
    echo 
"The file $filename exists";
} else {
    echo 
"The file $filename does not exist";
}
?>

錯誤/異常

失敗時拋出E_WARNING警告。

注釋

注意: 此函數(shù)的結(jié)果會被緩存。參見 clearstatcache() 以獲得更多細節(jié)。

小技巧

自 PHP 5.0.0 起, 此函數(shù)也用于某些 URL 包裝器。請參見 支持的協(xié)議和封裝協(xié)議以獲得支持 stat() 系列函數(shù)功能的包裝器列表。

參見

  • is_readable() - 判斷給定文件名是否可讀
  • is_writable() - 判斷給定的文件名是否可寫
  • is_file() - 判斷給定文件名是否為一個正常的文件
  • file() - 把整個文件讀入一個數(shù)組中