# is_file

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

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

### 说明

is_file(string `$filename`): bool

判断指定文件名是否为正常的文件。如果 `filename` 是符号链接，将会解析符号链接并提供有关所引用文件的信息。

### 参数

`filename`

  文件的路径。

### 返回值

如果文件存在且为正常的文件则返回 `true`，否则返回 `false`。

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

### 错误／异常

失败时抛出 `E_WARNING` 警告。

### 示例

示例 #1 is_file() 例子

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

以上示例会输出：

    bool(true)
    bool(false)

### 注释

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

小技巧

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

### 参见

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open