[函数]Directory::rewind()函数—用法及示例

函数名：Directory::rewind() 适用版本：PHP 4, PHP 5, PHP 7

用法： Directory::rewind() 函数用于将目录句柄指向目录的起始位置。在读取目录内容之前，需要首先调用该函数。

语法： bool Directory::rewind ( void )

参数：该函数没有参数。

返回值：如果成功将目录句柄指向目录起始位置，则返回 true。如果失败，则返回 false。

示例： 以下示例演示了如何使用 Directory::rewind() 函数来遍历目录中的文件：

$dir = new DirectoryIterator('/path/to/directory');

// 首先，检查是否为目录
if ($dir->isDir()) {
    // 调用 rewind() 函数来将目录句柄指向起始位置
    $dir->rewind();

    // 循环遍历目录中的文件
    while ($dir->valid()) {
        // 跳过 . 和 .. 目录
        if (!$dir->isDot()) {
            echo $dir->getFilename() . "<br>";
        }
        // 移动到下一个文件
        $dir->next();
    }
}

在上述示例中，首先使用 DirectoryIterator 类来打开指定目录的句柄。然后，使用 Directory::rewind() 函数将目录句柄指向起始位置。接下来，在 while 循环中，我们使用 Directory::valid() 函数来判断是否还有更多的文件需要遍历。对于每个文件，我们使用 DirectoryIterator 类的其他方法（如 getFilename()）来获取文件名，并将其输出到浏览器上。最后，我们使用 Directory::next() 函数移动到下一个文件。

注意：在使用 Directory::rewind() 函数之前，需要确保目录的打开和遍历操作是正确的。另外，记得在使用完目录之后，调用 closedir() 函数来关闭目录句柄，释放资源。