# 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 ```