is_dir
(PHP 4, PHP 5, PHP 7)
is_dir — Определяет, является ли имя файла директорией
Описание
$filename
) : boolОпределяет, является ли имя файла директорией.
Список параметров
-
filename
-
Путь к файлу. Если
filename
является относительным именем, он будет проверяться относительно текущей рабочей директории. Еслиfilename
является символической или жесткой ссылкой, то ссылка будет раскрыта и проверена. При включенном open_basedir могут применяться дальнейшие ограничения.
Возвращаемые значения
Возвращает true
, если файл существует и является директорией,
иначе возвращается false
.
Примеры
Пример #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)
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING
.
Примечания
Замечание: Результаты этой функции кешируются. Более подробную информацию смотрите в разделе clearstatcache().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat(), смотрите в разделе Поддерживаемые протоколы и обертки.