# rmdir

(PHP 4, PHP 5, PHP 7)

rmdir — 删除目录

### 说明

rmdir ( string `$dirname` [, resource `$context` ] ) : bool

尝试删除 `dirname` 所指定的目录。 该目录必须是空的，而且要有相应的权限。 失败时会产生一个 `E_WARNING` 级别的错误。

### 参数

`dirname`

  目录的路径。

`context`

  > Note: 在 PHP 5.0.0 中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见 Streams。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
5.0.0 | 自 PHP 5.0.0 起 rmdir() 也可用于某些 URL 封装协议。参见支持的协议和封装协议 的列表看看 rmdir() 支持哪些 URL 封装协议。

### 范例

Example #1 rmdir() 例子

    <?php
    if (!is_dir('examples')) {
        mkdir('examples');
    }

    rmdir('examples');
    ?>

### 注释

> Note: 当启用 安全模式时， PHP 会在执行脚本时检查被脚本操作的目录是否与被执行的脚本有相同的 UID（所有者）。

### 参见

- is_dir() - 判断给定文件名是否是一个目录
- mkdir() - 新建目录
- unlink() - 删除文件