opendir

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

opendir打开目录句柄

说明

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

打开一个目录句柄,可用于之后的 closedir()readdir()rewinddir() 调用中。

参数

directory

要打开的目录路径

context

context 参数的说明见手册中的 Streams API 一章。

返回值

如果成功则返回目录句柄的 resource, 或者在失败时返回 false

错误/异常

失败时抛出 E_WARNING 警告。

如果 directory 不是有效的目录,由于权限不足或文件系统错误而无法打开目录,则可能会发生这种情况。

更新日志

版本 说明
8.0.0 现在 context 允许为 null。

示例

示例 #1 opendir() 示例

<?php
$dir
= "/etc/php5/";

// 打开已知目录,然后继续读取内容
if (is_dir($dir)) {
if (
$dh = opendir($dir)) {
while ((
$file = readdir($dh)) !== false) {
echo
"filename: $file : filetype: " . filetype($dir . $file) . "\n";
}
closedir($dh);
}
}
?>

以上示例的输出类似于:

filename: . : filetype: dir
filename: .. : filetype: dir
filename: apache : filetype: dir
filename: cgi : filetype: dir
filename: cli : filetype: dir

参见

  • is_dir() - 判断给定文件名是否是一个目录
  • readdir() - 从目录句柄中读取条目
  • dir() - 返回一个 Directory 类实例