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

# is_dir

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

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

### 説明

function is_dir(string `$filename`): bool

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

### パラメータ

`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() - ファイルがシンボリックリンクかどうかを調べる

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