PHP4手册:函数库及函数(十一) 目录管理函式库

--------------------------------------------------------------------------------
 目录管理函式库 
--------------------------------------------------------------------------------
 

本函式库共有 6 个函式
chdir: 改变目录。 
dir: 目录类别物件。 
closedir: 关闭目录 handle。 
opendir: 开启目录 handle。 
readdir: 读取目录 handle。 
rewinddir: 重设目录 handle。 

--------------------------------------------------------------------------------
 函式:chdir() 
--------------------------------------------------------------------------------
 

目录管理函式库

chdir
改变目录。

语法: int chdir(string directory);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式用来改变目前 PHP 执行的目录到新的 directory 目录中。若无法改变则传回 false，成功则传回 true。
 

--------------------------------------------------------------------------------
 函式:dir() 
--------------------------------------------------------------------------------
 

目录管理函式库

dir
目录类别物件。

语法: new dir(string directory);

传回值: 物件

函式种类: 档案存取

 
 
内容说明 

这是一个类似物件导向的类别物件，用来读取目录。当目录参数 directory 开启之后，有二个属性可用：handle 属性就像其它非物件的函式所用的 readdir()、rewinddir() 及 closedir()；path 属性则设定开启目录后的路径参数。本物件有三个方法 (method)：read、rewind 与 close。

 
 
使用范例 

$d = dir("/etc");
echo "Handle: ".$d->handle."
\n";
echo "Path: ".$d->path."
\n";
while($entry=$d->read()) {
    echo $entry."
\n";
}
$d->close();
?> 

--------------------------------------------------------------------------------
 函式:closedir() 
--------------------------------------------------------------------------------
 

目录管理函式库

closedir
关闭目录 handle。

语法: void closedir(int dir_handle);

传回值: 无

函式种类: 档案存取

 
 
内容说明 

本函式用来关闭目录资料流的 dir_handle。这个 dir_handle 参数所操作的目录必须要 opendir() 开启的方可使用。
 

--------------------------------------------------------------------------------
 函式:opendir() 
--------------------------------------------------------------------------------
 

目录管理函式库

opendir
开启目录 handle。

语法: int opendir(string path);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式用来开启目录资料流。传回的整数是可供其它目录函式操作的 handle。
 

--------------------------------------------------------------------------------
 函式:readdir() 
--------------------------------------------------------------------------------
 

目录管理函式库

readdir
读取目录 handle。

语法: string readdir(int dir_handle);

传回值: 字串

函式种类: 档案存取

 
 
内容说明 

本函式用来读取目录。传回目录中的档案名称，读取不照任何特殊的顺序。

 
 
使用范例 

本例列出目前目录的所有档案

$handle=opendir('.');
echo "目录 handle: $handle\n";
echo "档案:\n";
while ($file = readdir($handle)) {
    echo "$file\n";
}
closedir($handle); 
?>

--------------------------------------------------------------------------------
 函式:rewinddir() 
--------------------------------------------------------------------------------
 

目录管理函式库

rewinddir
重设目录 handle。

语法: void rewinddir(int dir_handle);

传回值: 无

函式种类: 档案存取

 
 
内容说明 

本函式用来重设目录资料流到开始处。