Определяет, указывает ли путь на каталог

# is_dir

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

is_dir — Определяет, указывает ли путь на каталог

### Описание

function is_dir(string `$filename`): bool

Функция определяет, ведёт ли путь к каталогу.

### Список параметров

`filename`

  Путь к файлу. При передаче в параметр `filename` относительного пути функция проверит путь относительно текущей рабочей директории. При передаче в параметр `filename` символической или жёсткой ссылки функция разрешит ссылку и проверит, указывает ли на каталог целевой путь ссылки. Директива open_basedir дополнительно ограничит для PHP доступ к дереву каталогов, если настройку включили в файле конфигурации.

### Возвращаемые значения

Функция возвращает `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() - Возвращает экземпляр класса Directory
- opendir() - Открывает дескриптор каталога
- is_file() - Сообщает, ведёт ли путь к стандартному файлу
- is_link() - Сообщает, указывает ли путь на символическую ссылку

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