array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.file-exists.php', 1 => 'file_exists', 2 => 'Verifica si un fichero o un directorio existe', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.file.php', 1 => 'file', ), 'next' => array ( 0 => 'function.file-get-contents.php', 1 => 'file_get_contents', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/file-exists.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

file_exists

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

file_exists — Verifica 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 se almacenan 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