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: Como el tipo entero de PHP es firmado y que muchas plataformas utilizan enteros de 32 bits, algunas funciones relacionadas con el sistema de archivos pueden retornar resultados extraños para archivos de tamaño superior a 2 Go.

Errores/Excepciones

En caso de fallo, se emitirá una advertencia de tipo 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 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

  • 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