opendir

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

説明

resourcefalse opendir(string $directory, resourcenull $context = null)

ディレクトリハンドルをオープンします。このハンドルは、この後 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