is_file

(PHP 4, PHP 5, PHP 7)

is_file判断给定文件名是否为一个正常的文件

说明

is_file ( string $filename ) : bool

判断给定文件名是否为一个正常的文件。

参数

filename

文件的路径。

返回值

如果文件存在且为正常的文件则返回 TRUE,否则返回 FALSE

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

范例

Example #1 is_file() 例子

<?php
var_dump
(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>

以上例程会输出:

bool(true)
bool(false)

错误/异常

失败时抛出E_WARNING警告。

注释

Note: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。

Tip

自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。

参见

  • is_dir() - 判断给定文件名是否是一个目录
  • is_link() - 判断给定文件名是否为一个符号连接