Php/docs/function.dir

• PHP Manual
• 目录函数函数
• 返回一个 Directory 类实例

dir

(PHP 4, PHP 5, PHP 7)

dir — 返回一个 Directory 类实例

说明

dir ( string $directory [, resource $context ] ) : Directory

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

参数

directory

被打开的目录

context

Note: 在 PHP 5.0.0

中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见

Streams。

返回值

成功的话，返回一个 Directory 类实例, 参数错误的情况下返回 null ， 其它错误情况返回 false 。

范例

Example #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

注释

Note:

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