file_exists

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

file_existsVerifica si un fichero o un directorio existe

Descripción

file_exists(string $filename): bool

Verifica si un fichero o un directorio existe.

Parámetros

filename

Ruta de acceso al fichero o directorio.

En Windows, utilice el formato de ruta //computername/share/filename o \\\\computername\share\filename para verificar que un fichero está disponible en el recurso compartido.

Valores devueltos

Devuelve true si el fichero o directorio especificado por el argumento filename existe; false en caso contrario.

Nota:

Devuelve false para los enlaces simbólicos que apuntan a un fichero que no existe.

Nota:

La verificación se realiza utilizando el UID/GID real en lugar del efectivo.

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.

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

Ejemplos

Ejemplo #1 Prueba la existencia de un fichero

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

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

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 accesible en lectura
  • is_writable() - Indica si un fichero es accesible en escritura
  • is_file() - Indica si el fichero es un fichero verdadero
  • file() - Lee el fichero y devuelve el resultado en un array
  • SplFileInfo