file_exists

(PHP 4, PHP 5, PHP 7)

file_existsComprueba si existe un fichero o directorio

Descripción

file_exists ( string $filename ) : bool

Comprueba si existe un fichero o directorio.

Parámetros

filename

Ruta del fichero o directorio.

En windows, use //nombre_equipo/recurso/nombre_fichero o \\nombre_equipo\recurso\nombre_fichero para comprobar ficheros en redes compartidas.

Valores devueltos

Devuelve TRUE si el fichero o directorio especificado por filename existe; FALSE si no.

Nota:

Esta función devolverá FALSE para punteros de enlaces simbólicos hacia ficheros no existentes.

Advertencia

Esta función devuelve FALSE para ficheros inaccesibles a causa de las restricciones del modo seguro. Sin embargo, estos fichero aún pueden ser incluidos si están localizados en safe_mode_include_dir.

Nota:

La comprobación se realiza usando el UID/GID real en vez del oportuno.

Nota: Debido a que el tipo integer de PHP es con signo y muchas plataformas usan enteros de 32 bits, algunas funciones de sistema de ficheros pueden devolver resultados inesperados para ficheros que son mayores de 2 GB.

Ejemplos

Ejemplo #1 Comprobar si existe un fichero

<?php
$nombre_fichero 
'/path/to/foo.txt';

if (
file_exists($nombre_fichero)) {
    echo 
"El fichero $nombre_fichero existe";
} else {
    echo 
"El fichero $nombre_fichero no existe";
}
?>

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

  • is_readable() - Indica si un fichero existe y es legible
  • is_writable() - Indica si un archivo existe y es escribible
  • is_file() - Indica si el nombre de fichero es un fichero normal
  • file() - Transfiere un fichero completo a un array