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 emitirá una advertencia de tipo 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 ejemplo anterior mostrará :

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

Notas

Nota: Los resultados de esta función están en caché. Véase la función clearstatcache() para más detalles.

Sugerencia

A partir de PHP 5.0.0, esta función también puede ser utilizada con algunos protocolos url. Lea Protocolos y Envolturas soportados para conocer los protocolos que soportan la familia de funcionalidades 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