dir

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

dir — 返回一個(gè) Directory 類實(shí)例

說(shuō)明

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

以面向?qū)ο蟮姆绞皆L問(wèn)目錄。打開(kāi) directory 參數(shù)指定的目錄。

參數(shù)

directory

被打開(kāi)的目錄

context

上下文流（context stream） resource。

返回值

返回 Directory 的實(shí)例，出現(xiàn)錯(cuò)誤時(shí)返回 false。

更新日志

版本 說(shuō)明
8.0.0 context 現(xiàn)在可為空（nullable）。

范例

示例 #1 dir() 示例

請(qǐng)?zhí)貏e注意下面示例中 Directory::read() 函數(shù)返回值的判斷方式。 我們嚴(yán)格測(cè)試（值相等，并且類型相同，請(qǐng)參考 比較運(yùn)算符 ）返回值等于 false ，因?yàn)橛行┣闆r下，目錄名可能"等于" false ，導(dǎo)致 跳出循環(huán)。

<?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

注釋

注意:

目錄條目返回的順序依賴于系統(tǒng)。