dir
(PHP 4, PHP 5)
dir — 返回一个 Directory 类实例
说明
Directory dir
( string $directory
[, resource $context
] )
以面向对象的方式访问目录。打开
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:
目录条目返回的顺序依赖于系统。