readdir

(PHP 4, PHP 5, PHP 7)

readdir - 从目录句柄读取条目

描述

string readdir ([ resource $dir_handle ] )

返回目录中下一个条目的名称。这些条目按文件系统存储的顺序返回。

参数

dir_handle

之前用opendir()打开的目录句柄资源。如果未指定目录句柄，则假定由opendir()打开的最后一个链接。

返回值

成功返回条目名称或失败时返回FALSE。

警告

该函数可能返回布尔值FALSE，但也可能返回一个非布尔值，其值为FALSE。有关更多信息，请阅读布尔部分。使用===运算符来测试此函数的返回值。

示例

示例＃1列出目录中的所有条目

请注意以下示例中readdir()的返回值被检查的方式。我们正在明确测试返回值是否相同（等于和相同的类型 - 请参阅比较运算符以获取更多信息）FALSE，否则，其名称计算为的所有目录条目FALSE都将停止循环（例如名为“0 “）。

<?php

if ($handle = opendir('/path/to/files')) {
    echo "Directory handle: $handle\n";
    echo "Entries:\n";

    /* This is the correct way to loop over the directory. */
    while (false !== ($entry = readdir($handle))) {
        echo "$entry\n";
    }

    /* This is the WRONG way to loop over the directory. */
    while ($entry = readdir($handle)) {
        echo "$entry\n";
    }

    closedir($handle
}
?>

示例＃2列出当前目录中的所有条目并去除 。 和 ..

<?php
if ($handle = opendir('.')) {
    while (false !== ($entry = readdir($handle))) {
        if ($entry != "." && $entry != "..") {
            echo "$entry\n";
        }
    }
    closedir($handle
}
?>

另请参阅

is_dir() - 告诉文件名是否是一个目录

glob() - 查找与模式匹配的路径名

scandir() - 列出指定路径内的文件和目录

← opendir

rewinddir →