dir

编辑

(PHP 4, PHP 5, PHP 7)

dir — 返回一个 Directory 实例

PHP中文网词条详解说明

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

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

PHP中文网词条详解参数

directory

被打开的目录

context

注: 在 PHP 5.0.0 中增加了对上下文(Context)的支持。有关上下文(Context)的说明参见 Streams。

PHP中文网词条详解返回值

成功的话,返回一个 Directory 实例, 参数错误的情况下返回 NULL , 其它错误情况返回 FALSE 。 

PHP中文网词条详解范例

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中文网词条详解注释

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

参考资料
    词条标签:
    directory