is_dir

ファイルがディレクトリかどうかを調べる

説明

bool is_dir(string $filename)

指定したファイルがディレクトリかどうかを調べます。

パラメータ

filename

ファイルへのパス。filename が相対パスの場合は、現在の作業ディレクトリからの相対パスとして処理します。 filename がシンボリックリンクあるいはハードリンクの場合は、 リンク先を解決して処理します。 open_basedir を有効にすると、 さらに制限がかかるでしょう。

戻り値

ファイルが存在して、かつそれがディレクトリであれば true、それ以外の場合は false を返します。

エラー / 例外

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

例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)

注意

注意: この関数の結果は キャッシュされます。詳細は、clearstatcache を参照してください。

ヒント

PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。

参考

  • chdir
  • dir
  • opendir
  • is_file
  • is_link