opendir

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

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

説明

opendir(string $directory, ?resource $context = null): resource|false

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

パラメータ

directory

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

context

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

戻り値

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

エラー / 例外

失敗したときは E_WARNING が発生します。

directory が有効なディレクトリでない場合、 権限の制限によりディレクトリがオープンできない場合、 またはファイルシステムのエラー時に起こりえます。

変更履歴

バージョン 説明
8.0.0 context は、nullable になりました。

例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

参考

  • is_dir() - ファイルがディレクトリかどうかを調べる
  • readdir() - ディレクトリハンドルからエントリを読み込む
  • dir() - ディレクトリクラスのインスタンスを返す

関連キーワード:  ディレクトリ, ハンドル, オープン, filetype, filename, opendir, context, readdir, directory, resource