is_dir
(PHP 4, PHP 5)
is_dir — ファイルがディレクトリかどうかを調べる
説明
bool is_dir
( string $filename
)
指定したファイルがディレクトリかどうかを調べます。
パラメータ
- filename
-
ファイルへのパス。filename が相対パスの場合は、現在の作業ディレクトリからの相対パスとして処理します。 filename がシンボリックリンクあるいはハードリンクの場合は、 リンク先を解決して処理します。セーフモード あるいは open_basedir を有効にすると、 さらに制限がかかるでしょう。
返り値
ファイルが存在して、かつそれがディレクトリであれば TRUE、それ以外の場合は FALSE を返します。
例
例1 is_dir() の例
<?php
var_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() ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。
