is_file

通常ファイルかどうかを調べる

説明

bool is_file(string $filename)

指定したファイルが通常のファイルかどうかを調べます。

パラメータ

filename

ファイルへのパス。

戻り値

ファイルが存在し、かつそれが通常のファイルである場合に true、 それ以外の場合に false を返します。

注意: PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 ファイルシステム関数の中には 2GB より大きなファイルについては期待とは違う値を返すものがあります。

エラー / 例外

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

例1 is_file の例

<?php
var_dump
(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>

上の例の出力は以下となります。

bool(true)
bool(false)

注意

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

ヒント

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

参考

  • is_dir
  • is_link
  • SplFileInfo