PHP 手冊
後退前進


dir

(PHP 3, PHP 4, PHP 5)

dir -- directory 類

說明

class dir {

dir ( string directory )

string path

resource handle

string read ( void )

void rewind ( void )

void close ( void )

}

這是個仿冒面向對象的機制來讀取一個目錄。給定的 directory 被開啟。一旦目錄被開啟，有兩個屬性可用。handle 屬性可以用在其它目錄函數例如 readdir()，rewinddir() 和 closedir() 中。path 屬性被設為被開啟的目錄路徑。有三個方法可用：read，rewind 和 close。

範例

例子 1. dir() 例子

請留意下面例子中檢查 dir() 返回值的風格。我們明確地測試返回值是否全等於（值和類型都相同 － 更多訊息參見比較運算符）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

注解

注: read 方法返回的目錄項的順序依賴於系統。

注: 本函數定義了內定類 Directory，意味著不能再用同樣的名字定義會員自己的類。PHP 預定義類的完整清單見預定義類一節。



後退起點前進
chroot上一級closedir