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

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

El resultado del ejemplo sería:

bool(true)
bool(false)

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