is_dir

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

is_dir — Определяет, является ли имя файла директорией

Описание

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