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