無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

opendir

(PHP 4, PHP 5)

opendirディレクトリハンドルをオープンする

説明

resource opendir ( string $path [, resource $context ] )

ディレクトリハンドルをオープンします。このハンドルは、この後 closedir(), readdir(), rewinddir() 関数コールで使用されます。

パラメータ

path

オープンするディレクトリのパス。

context

context パラメータの詳細については マニュアルのストリーム を参照ください。

返り値

成功した場合にディレクトリハンドルの resource 、 失敗した場合に FALSE を返します。

path が有効なディレクトリでないかまたは権限が 制限されているかファイルシステムのエラーによりディレクトリが オープンできない場合、opendir()FALSE を返し、 E_WARNING エラーが発行されます。 opendir() のこのエラー出力は、 関数名の前に '@' を付けることにより抑制できます。

変更履歴

バージョン 説明
5.0.0 pathftp:// URL ラッパをサポートします。
4.3.0 path に、ディレクトリの一覧表示をサポートする URL を指定することが可能です。しかし、PHP 4 では file:// URL ラッパのみをサポートしています。

例1 opendir() の例

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

// 既知のディレクトリをオープンし、その内容を読み込みます。
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