array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.is-dir.php', 1 => 'is_dir', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.glob.php', 1 => 'glob', ), 'next' => array ( 0 => 'function.is-executable.php', 1 => 'is_executable', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/is-dir.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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(), смотрите в разделе Поддерживаемые протоколы и обёртки.