hash_file

(PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL hash >= 1.1)

hash_file — Génère une valeur de hachage en utilisant le contenu d'un fichier donné

Description

hash_file(
    string $algo,
    string $filename,
    bool $binary = false,
    array $options = []
): string|false

Liste de paramètres

algo: Nom de l'algorithme de hachage sélectionné (par exemple : "sha256"). Pour une liste des algorithmes disponibles voir hash_algos().
filename: URL indiquant l'emplacement du fichier qui sera haché ; Supporte les enveloppes fopen().
binary: Lorsqu'il vaut true, la sortie sera des données brutes binaires. Lorsqu'il vaut false, la sortie sera des chiffres hexadécimaux en minuscule.
options: Un tableau d'options pour les différents algorithmes de hachage. Actuellement, seul le paramètre "seed" est supporté pour les variantes MurmurHash.

Valeurs de retour

Retourne une chaîne de caractères contenant l'empreinte numérique calculée en chiffre hexadécimal minuscule à moins que binary soit fixé à true. Dans ce cas, la représentation brute binaire de l'empreinte numérique est retournée, ou false si une erreur survient.

Historique

Version Description

8.1.0 Le paramètre options a été ajouté.

Version	Description
8.1.0	Le paramètre `options` a été ajouté.

Exemples

Exemple #1 Exemple avec hash_file()

<?php
/* Crée un fichier pour calculer son empreinte numérique */
file_put_contents('example.txt', 'The quick brown fox jumped over the lazy dog.');

echo hash_file('sha256', 'example.txt');
?>

L'exemple ci-dessus va afficher :

68b1282b91de2c054c36629cb8dd447f12f096d3e3c587978dc2248444633483

Voir aussi

hash_init() - Initialise un contexte de hachage incrémental
hash_hmac_file() - Génère une valeur de clé de hachage en utilisant la méthode HMAC et le contenu d'un fichier donné