大网数据广告活动
PHP 语言与运行手册

返回一个 Directory 类实例

· 52CE 我爱测

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

dir

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

dir — 返回一个 Directory 类实例

说明

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

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

参数

directory

被打开的目录

context

上下文流(context stream) resource。

返回值

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

更新日志

版本 说明
8.0.0 context 现在可为空(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

注释

注意:

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

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。