is_dir

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

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

Описание

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() - Сообщает, указывает ли путь на символическую ссылку