is_file

(PHP 4, PHP 5, PHP 7)

is_fileIndica si el nombre de fichero es un fichero normal

Descripción

is_file ( string $filename ) : bool

Indica si el fichero dado es un fichero normal.

Parámetros

filename

Ruta del fichero.

Valores devueltos

Devuelve TRUE si el nombre de fichero existe y es un fichero normal, FALSE si no.

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.

Ejemplos

Ejemplo #1 Ejemplo de is_file()

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

El resultado del ejemplo sería:

bool(true)
bool(false)

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

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_dir() - Indica si el nombre de archivo es un directorio
  • is_link() - Indica si el nombre de archivo es un enlace simbólico