is_file
(PHP 4, PHP 5, PHP 7)
is_file — 通常ファイルかどうかを調べる
説明
is_file
( string $filename
) : bool
指定したファイルが通常のファイルかどうかを調べます。
パラメータ
filename
- ファイルへのパス。
返り値
ファイルが存在し、かつそれが通常のファイルである場合に true
、
それ以外の場合に false
を返します。
注意:
PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 ファイルシステム関数の中には 2GB より大きなファイルについては期待とは違う値を返すものがあります。
例
例1 is_file() の例
<?phpvar_dump(is_file('a_file.txt')) . "\n";var_dump(is_file('/usr/bin/')) . "\n";?>
上の例の出力は以下となります。
bool(true) bool(false)
エラー / 例外
失敗したときは E_WARNING
が発生します。
注意
注意:
この関数の結果はキャッシュされます。詳細は、clearstatcache() を参照してください。
ヒント
PHP 5.0.0
以降、この関数は、
何らかの URL ラッパーと組合せて使用することができます。
どのラッパーが stat() ファミリーをサポートしているかを調べるには
サポートするプロトコル/ラッパー を参照してください。