file_exists

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

file_exists — 检查文件或目录是否存在

说明

file_exists(string $filename): bool

检查文件或目录是否存在。

参数

filename

文件或目录的路径。

在 Windows 中要用 //computername/share/filename 或者 \\computername\share\filename 来检查网络中的共享文件。

返回值

如果由 filename 指定的文件或目录存在则返回 true，否则返回 false。

注意:
对于指向文件不存在的符号链接，此函数将会返回 false。

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

注意: 因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型，对 2GB 以上的文件，一些文件系统函数可能返回无法预期的结果。

错误／异常

失败时抛出 E_WARNING 警告。

示例

示例 #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 警告。

参见

is_readable() - 判断给定文件名是否可读
is_writable() - 判断给定的文件名是否可写
is_file() - 判断给定文件名是否为一个正常的文件
file() - 把整个文件读入一个数组中
SplFileInfo