# is_dir

(PHP 4, PHP 5, PHP 7)

is_dir — 判断给定文件名是否是一个目录

### 说明

is_dir ( string `$filename` ) : bool

判断给定文件名是否是一个目录。

### 参数

`filename`

  如果文件名存在并且为目录则返回 `TRUE`。如果 `filename` 是一个相对路径，则按照当前工作目录检查其相对路径。 If `filename` is a symbolic or hard link then the link will be resolved and checked. If you have enabled 安全模式, or open_basedir further restrictions may apply.

### 返回值

如果文件名存在，并且是个目录，返回 `TRUE`，否则返回`FALSE`。

### 范例

Example #1 is_dir() 例子

    <?php
    var_dump(is_dir('a_file.txt'));
    var_dump(is_dir('bogus_dir/abc'));

    var_dump(is_dir('..')); //one dir up
    ?>

以上例程会输出：

    bool(false)
    bool(false)
    bool(true)

### 错误／异常

失败时抛出`E_WARNING`警告。

### 注释

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

Tip

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

### 参见

- chdir() - 改变目录
- dir() - 返回一个 Directory 类实例
- opendir() - 打开目录句柄
- is_file() - 判断给定文件名是否为一个正常的文件
- is_link() - 判断给定文件名是否为一个符号连接