# opendir

(PHP 4, PHP 5, PHP 7)

opendir — 打开目录句柄

### 说明

opendir ( string `$path` [, resource `$context` ] ) : resource

打开一个目录句柄，可用于之后的 closedir()，readdir() 和 rewinddir() 调用中。

### 参数

`path`

  要打开的目录路径

`context`

  `context` 参数的说明见手册中的 Streams API 一章。

### 返回值

如果成功则返回目录句柄的 resource，失败则返回 `FALSE`。

如果 `path` 不是一个合法的目录或者因为权限限制或文件系统错误而不能打开目录，opendir() 返回 `FALSE` 并产生一个 E_WARNING 级别的 PHP 错误信息。可以在 opendir() 前面加上“@”符号来抑制错误信息的输出。

### 更新日志

版本 | 说明
--- | ---
5.0.0 | `path` 支持 ftp:// URL wrapper
4.3.0 | `path` 可以是任何支持目录列表的 URL，不过在 PHP 4 中只有 file:// URL wrapper 支持此功能

### 范例

Example #1 opendir() 例子

    <?php
    $dir = "/etc/php5/";

    // Open a known directory, and proceed to read its contents
    if (is_dir($dir)) {
        if ($dh = opendir($dir)) {
            while (($file = readdir($dh)) !== false) {
                echo "filename: $file : filetype: " . filetype($dir . $file) . "\n";
            }
            closedir($dh);
        }
    }
    ?>

以上例程的输出类似于：

    filename: . : filetype: dir
    filename: .. : filetype: dir
    filename: apache : filetype: dir
    filename: cgi : filetype: dir
    filename: cli : filetype: dir

### 参见

- is_dir() - 判断给定文件名是否是一个目录
- readdir() - 从目录句柄中读取条目
- dir() - 返回一个 Directory 类实例