(PHP 4, PHP 5, PHP 7)
is_dir — ファイルがディレクトリかどうかを調べる
$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() ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。