PHP Manual»Fonctions Fileinfo»finfo_file

finfo_file

finfo::file

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

finfo_file -- finfo::file — Retourne des informations à propos d'un fichier

Description

Style procédural

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

Style orienté objet

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

Cette fonction est utilisée pour récupérer des informations à propos d'un fichier.

Liste de paramètres

finfo: Une instance finfo, retourné par finfo_open().
filename: Nom d'un fichier à vérifier.
flags: Une ou une union de plusieurs constantes Fileinfo.
context: Pour une description de contexts, se référer à Fonctions sur les flux.

Valeurs de retour

Retourne une description textuelle du contenu de l'argument filename ou false si une erreur s'est produite.

Erreurs / Exceptions

Lève une ValueError si filename contient un octet nul. Avant PHP 8.5.0, une TypeError était levée à la place.

Historique

Version	Description
8.5.0	Une ValueError est désormais levée à la place d'une TypeError lorsque `filename` contient un octet nul.
8.1.0	La paramètre `finfo` attend désormais une instance de finfo ; auparavant, une resource était attendu.
8.0.0	`context` est désormais nullable.

Exemples

Exemple #1 Exemple avec finfo_file()

<?php
$finfo = finfo_open(FILEINFO_MIME_TYPE); // Retourne le type mime autrement appelé extension mimetype
foreach (glob("*") as $filename) {
    echo finfo_file($finfo, $filename) . "\n";
}
finfo_close($finfo);
?>

Résultat de l'exemple ci-dessus est similaire à :

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

Voir aussi

finfo_buffer() - Retourne des informations à propos d'une chaîne de caractères tampon