file_exists

file_exists

(PHP 4, PHP 5, PHP 7)

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

描述

bool file_exists ( string $filename )

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

参数

filename

文件或目录的路径。

在Windows上，使用// computername / share / filename或\ computername \ share \ filename来检查网络共享上的文件。

返回值

TRUE如果指定的文件或目录filename存在，则返回; FALSE除此以外。

注意：此函数将返回FALSE指向不存在文件的符号链接。

警告

FALSE由于安全模式限制，此功能返回文件无法访问。但是，如果这些文件位于safe_mode_include_dir中，它们仍然可以包含在内。

注意：检查使用真实的UID / GID而不是有效的检查。

注意：由于PHP的整数类型是有符号的，并且许多平台使用32位整数，所以对于大于2GB的文件，某些文件系统函数可能会返回意外的结果。

例子

Example #1 Testing whether a file exists

<?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发射。

注意

注意：这个函数的结果被缓存。有关更多详细信息，请参阅clearstatcache（）。

提示

从PHP 5.0.0开始，这个函数也可以用于一些 URL包装器。请参阅支持的协议和包装以确定哪些包装支持stat（）系列功能。