opendir

(PHP 4, PHP 5, PHP 7, PHP 8)

opendir打開目錄句柄

說明

opendir(string $path, resource $context = ?): resource

打開一個目錄句柄,可用于之后的 closedir(),readdir()rewinddir() 調(diào)用中。

參數(shù)

path

要打開的目錄路徑

context

context 參數(shù)的說明見手冊中的 Streams API 一章。

返回值

如果成功則返回目錄句柄的 resource,失敗則返回 false。

如果 path 不是一個合法的目錄或者因?yàn)闄?quán)限限制或文件系統(tǒng)錯誤而不能打開目錄,opendir() 返回 false 并產(chǎn)生一個 E_WARNING 級別的 PHP 錯誤信息??梢栽?opendir() 前面加上“@”符號來抑制錯誤信息的輸出。

更新日志

版本 說明
5.0.0 path 支持 ftp:// URL wrapper
4.3.0 path 可以是任何支持目錄列表的 URL,不過在 PHP 4 中只有 file:// URL wrapper 支持此功能

范例

示例 #1 opendir() 例子

<?php
$dir 
"/etc/php5/";

// Open a known directory, and proceed to read its contents
if (is_dir($dir)) {
    if (
$dh opendir($dir)) {
        while ((
$file readdir($dh)) !== false) {
            echo 
"filename: $file : filetype: " filetype($dir $file) . "\n";
        }
        
closedir($dh);
    }
}
?>

以上例程的輸出類似于:

filename: . : filetype: dir
filename: .. : filetype: dir
filename: apache : filetype: dir
filename: cgi : filetype: dir
filename: cli : filetype: dir

參見

  • is_dir() - 判斷給定文件名是否是一個目錄
  • readdir() - 從目錄句柄中讀取條目
  • dir() - 返回一個 Directory 類實(shí)例