PHP中opendir函数用法实例

1. 概述

在PHP中，opendir是用于打开目录的内建函数之一。在本篇攻略中，我们将详细介绍opendir函数的各个参数和用法，并给出两个示例说明。

2. opendir函数的语法

opendir函数的语法如下：

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

其中，$path参数表示要打开的目录路径，是一个字符串类型的参数；$context参数是可选的，表示指定目录打开的上下文。opendir函数返回一个句柄类型的资源（resource）。

3. opendir函数的参数说明

参数 `$path`

$path参数表示要打开的目录路径，可以是相对路径或绝对路径，但必须是一个合法的路径。如果路径不存在或不可读取，则该函数将返回false。

参数 `$context`

$context参数表示指定目录打开的上下文，是一个可选的参数。如果需要指定上下文，请使用流上下文（stream context），并指定选项'options'。例如：

$ctx = stream_context_create(['options' => ['open_basedir' => '/path/to/dir']]);
$dh = opendir('./', $ctx);

上述代码在尝试打开当前目录时，会将其限制在'/path/to/dir'目录下。

4. opendir函数的返回值

opendir函数返回一个句柄类型的资源（resource）。如果目录打开成功，则返回一个目录句柄（directory handle），可用于读取目录中的文件列表。如果打开失败，则返回false。

5. 使用示例

示例一：读取目录中的所有文件列表

下面是一个简单示例，用于打开一个目录、读取其中的所有文件并打印出其文件名：

$path = './';
if ($dh = opendir($path)) {
    while (($file = readdir($dh)) !== false) {
        if ($file != '.' && $file != '..') {
            echo "$file\n";
        }
    }
    closedir($dh);
}

上述代码中，我们首先打开指定路径下的目录，然后使用readdir函数逐个读取其中的文件。注意，"."和".."这两个特殊的目录也会被读取到，需要在逐个读取时进行排除。

示例二：过滤指定类型文件

下面是另一个示例，用于打开一个目录、读取其中的指定类型（拓展名为.txt）文件，并打印出其文件名：

$path = './';
if ($dh = opendir($path)) {
    while (($file = readdir($dh)) !== false) {
        if (preg_match('/\.txt$/', $file)) {
            echo "$file\n";
        }
    }
    closedir($dh);
}

上述代码中，我们使用preg_match函数对文件名称进行正则匹配，仅打印出拓展名为.txt的文件。