(PHP 4, PHP 5, PHP 7, PHP 8)
is_dir — Определяет, является ли имя файла директорией
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(), смотрите в разделе Поддерживаемые протоколы и обёртки.