dir()函数—用法及示例

函数名称：dir()

函数描述：dir()函数用于打开目录句柄，并返回一个Directory对象，可以用来迭代目录中的文件和子目录。它是旧版本的目录遍历函数，在PHP 5.0.0之后被废弃，推荐使用更现代化的函数来代替。

适用版本：PHP 4 – PHP 4.3.7（由于在PHP 4.3.0之后已不在主流版本中支持，因此这个函数应该被视为已经被废弃和不推荐使用）

用法：

resource dir ( string $directory [, resource $context ] )

参数：

• $directory：要打开的目录路径。
• $context（可选）：一个Stream context资源。

返回值： 如果成功打开目录，则返回Directory对象的资源句柄，否则返回FALSE。

示例：

$dir = dir("/path/to/directory");  // 打开目录句柄
if ($dir) {
    while (false !== ($file = $dir->read())) {
        echo $file . "<br>";  // 输出目录下的文件名/子目录名
    }
    $dir->close();  // 关闭目录句柄
}

注意事项：

• 应该谨慎使用该函数，因为它不支持流式上下文（stream context）。
• 推荐使用更先进和可靠的函数如opendir()和readdir()来替代dir()函数。