is_dir
(PHP 4, PHP 5, PHP 7)
is_dir — ファイルがディレクトリかどうかを調べる
説明
is_dir
( string $filename
) : bool
指定したファイルがディレクトリかどうかを調べます。
パラメータ
filename
- ファイルへのパス。
filename
が相対パスの場合は、現在の作業ディレクトリからの相対パスとして処理します。filename
がシンボリックリンクあるいはハードリンクの場合は、 リンク先を解決して処理します。 open_basedir を有効にすると、 さらに制限がかかるでしょう。
返り値
ファイルが存在して、かつそれがディレクトリであれば
true
、それ以外の場合は false
を返します。
例
例1 is_dir() の例
<?phpvar_dump(is_dir('a_file.txt'));var_dump(is_dir('bogus_dir/abc'));var_dump(is_dir('..')); //一つ上のディレクトリ?>
上の例の出力は以下となります。
bool(false) bool(false) bool(true)
エラー / 例外
失敗したときは E_WARNING
が発生します。
注意
注意:
この関数の結果はキャッシュされます。詳細は、clearstatcache() を参照してください。
ヒント
PHP 5.0.0
以降、この関数は、
何らかの URL ラッパーと組合せて使用することができます。
どのラッパーが stat() ファミリーをサポートしているかを調べるには
サポートするプロトコル/ラッパー を参照してください。