is_dir

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

is_dirIndica si el fichero es un directorio

Descripción

is_dir(string $filename): bool

Indica si el fichero es un directorio.

Parámetros

filename

Ruta de acceso al fichero. Si filename es un fichero relativo, será verificado relativamente al directorio de trabajo actual. Si filename es un enlace simbólico o un enlace convencional, el enlace será resuelto y verificado. Si se ha activado open_basedir, pueden aplicarse más restricciones.

Valores devueltos

Devuelve true si el nombre de fichero existe y es un directorio, false en caso contrario.

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

Ejemplos

Ejemplo #1 Ejemplo con is_dir()

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

var_dump(is_dir('..')); // un directorio superior
?>

El resultado del ejemplo sería:

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

Notas

Nota: Los resultados de esta función son guardados en caché. Para más información ver clearstatcache().

Sugerencia

Desde PHP 5.0.0, esta función también puede usarse con algunos URL wrappers. Consultar Protocolos y Envolturas soportados para deter4minar qué envolturas soportan la familia de funcionalidad de stat().

Ver también

  • chdir() - Cambia de directorio
  • dir() - Devuelve una instancia de la clase Directory
  • opendir() - Abre un directorio y recupera un puntero sobre él
  • is_file() - Indica si el fichero es un fichero verdadero
  • is_link() - Indica si el fichero es un enlace simbólico