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

# is_file

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### 説明

function is_file(string `$filename`): bool

指定したファイルが通常のファイルかどうかを調べます。 `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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open