PHP Manual»Funciones de Fileinfo»finfo_file

finfo_file

finfo::file

(PHP >= 5.3.0, PHP 7, PHP 8, PECL fileinfo >= 0.1.0)

finfo_file -- finfo::file — Devuelve información acerca de un fichero

Descripción

Estilo procedimental

function finfo_file(
    finfo $finfo,
    string $filename,
    int $flags = FILEINFO_NONE,
    ?resource $context = null
): string|false

Estilo orientado a objetos

public function finfo::file(string $filename, int $flags = FILEINFO_NONE, ?resource $context = null): string|false

Esta función se utiliza para obtener información acerca de un fichero.

Parámetros

finfo: Una instancia finfo, retornada por finfo_open().
filename: Nombre de un fichero a verificar.
flags: Una o una unión de varias constantes Fileinfo.
context: Para una descripción de contexts, consúltese Funciones de Flujos.

Valores devueltos

Devuelve una descripción textual del contenido del argumento filename o false si ha ocurrido un error.

Errores/Excepciones

Lanza una ValueError si filename contiene bytes nulos. Antes de PHP 8.5.0, se lanzaba una TypeError en su lugar.

Historial de cambios

Versión	Descripción
8.5.0	Ahora se lanza una ValueError en lugar de una TypeError cuando `filename` contiene bytes nulos.
8.1.0	El parámetro `finfo` ahora espera una instancia de finfo ; anteriormente, una resource era esperado.
8.0.0	`context` ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con finfo_file()

<?php
$finfo = finfo_open(FILEINFO_MIME_TYPE); // Devuelve el tipo mime también llamado extensión mimetype
foreach (glob("*") as $filename) {
    echo finfo_file($finfo, $filename) . "\n";
}
finfo_close($finfo);
?>

Resultado del ejemplo anterior es similar a:

text/html
image/gif
application/vnd.ms-excel

Véase también

finfo_buffer() - Devuelve información acerca de un string de buffer