dir

    (PHP 4, PHP 5, PHP 7, PHP 8)

    dir — 返回一个 Directory 类实例

    说明

    dir(string$directory, ?resource$context = null): Directory|false

    以面向对象的方式访问目录。打开 directory 参数指定的目录。

    参数

    directory

    被打开的目录

    context

    上下文流（context stream）resource。

    返回值

    返回 Directory 的实例，出现错误时返回 false。

    更新日志

    版本说明
    8.0.0context 现在可为空（nullable）。

    示例

    示例 #1 dir() 示例

    请特别注意下面示例中 Directory::read() 函数返回值的判断方式。 我们严格测试（值相等，并且类型相同，请参考 比较运算符 ）返回值等于 false ，因为有些情况下，目录名可能"等于" false ，导致 跳出循环。

    <?php
    $d     = dir("/etc/php5");
    echo     "Handle: " . $d->handle . "\n";
    echo     "Path: " . $d->path . "\n";
    while (    false !== ($entry = $d->read())) {
    echo     $entry."\n";
    }
    $d->close();
    ?>

    以上示例的输出类似于：

    Handle: Resource id #2 Path: /etc/php5 . .. apache cgi cli

    注释

    注意:

    目录条目返回的顺序依赖于系统。

    To Top