# PHP dir() 函數 ## 定義和用法 dir() 函數打開一個目錄句柄，并返回一個對象。這個對象包含三個方法：read() , rewind() 以及 close()。 若成功，則該函數返回一個目錄流，否則返回 false 以及一個 error。可以通過在函數名前加上 "@" 來隱藏 error 的輸出。 ### 語法 ``` dir(directory) ``` | 參數 | 描述 | | --- | --- | | directory | 必需。規定目錄。 | ## 例子 ### 例子 1 ``` <?php //打開 images 目錄 $dir = dir("images"); //列出 images 目錄中的文件 while (($file = $dir->read()) !== false) { echo "filename: " . $file . "<br />"; } $dir->close(); ?> ``` 輸出： ``` filename: . filename: .. filename: cat.gif filename: dog.gif filename: food filename: horse.gif ``` ### 例子 2 如果 dir() 的輸出失敗，本例會隱藏錯誤： ``` <?php //打開 images 目錄 $dir = @ dir("images"); //列出 images 目錄中的文件 while (($file = $dir->read()) !== false) { echo "filename: " . $file . "<br />"; } $dir->close(); ?> ``` 輸出： ``` filename: . filename: .. filename: cat.gif filename: dog.gif filename: food filename: horse.gif ```