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