is_dir

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

is_dir — Tells whether the filename is a directory

Опис

is_dir(string $filename): bool

Tells whether the given filename is a directory.

Параметри

filename: Path to the file. If filename is a relative filename, it will be checked relative to the current working directory. If filename is a symbolic or hard link then the link will be resolved and checked. If you have enabled open_basedir further restrictions may apply.

Значення, що повертаються

Returns true if the filename exists and is a directory, false otherwise.

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

Приклади

Приклад #1 is_dir() example

<?php
var_dump(is_dir('a_file.txt'));
var_dump(is_dir('bogus_dir/abc'));

var_dump(is_dir('..')); //one dir up
?>

Поданий вище приклад виведе:

bool(false)
bool(false)
bool(true)

Примітки

Зауваження: Рузультати цієї функції кешуються. Докладніше: clearstatcache().

Підказка

Починаючи з PHP 5.0.0, ця функція також може бути використана з деякими URL-обгортками. На сторінці Підтримувані протоколи та обгортки вказано, які обгортки підтримують сімейство функцій stat().

Прогляньте також

chdir() - Change directory
dir() - Return an instance of the Directory class
opendir() - Open directory handle
is_file() - Tells whether the filename is a regular file
is_link() - Tells whether the filename is a symbolic link