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