is_dir

(PHP 4, PHP 5)

is_dir — Indica si el nombre de archivo es un directorio

Descripción

bool is_dir ( string $filename )

Indica si el nombre de archivo dado es un directorio.

Parámetros

filename

Ruta al archivo. Si filename es un nombre de archivo relativo, será verificado relativo al directorio de trabajo actual. Si filename es un enlace simbólico o duro, el enlace será resuelto y comprobado. Si tiene activado el modo seguro, o open_basedir se pueden aplicar más restricciones.

Valores devueltos

Devuelve TRUE si el nombre de archivo existe y es un directorio, FALSE si no.

Ejemplos

Ejemplo #1 Ejemplo de is_dir()

<?php
var_dump(is_dir('archivo.txt'));
var_dump(is_dir('directorio/abc'));

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

El resultado del ejemplo sería:

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

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

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 gestor de directorio
  • is_file() - Indica si el nombre de fichero es un fichero normal
  • is_link() - Indica si el nombre de archivo es un enlace simbólico