dir
(PHP 4, PHP 5, PHP 7, PHP 8)
dir — 返回一個 Directory 類實例
說明
以物件導向的方式訪問目錄。打開
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
註釋
注意:
目錄條目返回的順序依賴於系統。