is_file

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

is_fileIndica si el fichero es un fichero verdadero

Descripción

is_file(string $filename): bool

Indica si el fichero es un fichero verdadero. Si filename es un enlace simbólico, se resolverá el enlace y se proporcionará información sobre el fichero referenciado.

Parámetros

filename

Ruta de acceso al fichero.

Valores devueltos

Devuelve true si el nombre de fichero existe y es un fichero regular, false en caso contrario.

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 Ejemplo con is_file()

<?php
var_dump
(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>

El ejemplo anterior mostrará :

bool(true)
bool(false)

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