hash_hmac_file

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

hash_hmac_fileGénère une valeur de clé de hachage en utilisant la méthode HMAC et le contenu d'un fichier donné

Description

hash_hmac_file ( string $algo , string $filename , string $key [, bool $raw_output = FALSE ] ) : string

Liste de paramètres

algo

Nom de l'algorithme de hachage sélectionné (c'est-à-dire "md5", "sha256", "haval160,4", etc.). Voir la documentation sur la fonction hash_hmac_algos() pour connaitre la liste des algorithmes disponible.

filename

URL indiquant l'emplacement du fichier qui sera haché; Supporte les enveloppes fopen().

key

Clé secrète partagée utilisée pour générer la variance HMAC de l'empreinte numérique.

raw_output

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.

Valeurs de retour

Retourne une chaîne de caractères contenant l'empreinte numérique calculée en chiffre hexadécimal minuscule à moins que raw_output soit fixé à TRUE. Dans ce cas, la représentation brute binaire de l'empreinte numérique est retournée. Retourne FALSE lorsque l'algo est inconnus ou n'est pas une fonction de hachage cryptographique, ou si le fichier filename ne peut pas être lu.

Historique

Version Description
7.2.0 L'utilisation de fonctions de hachage non cryptographiques (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) a été désactivée.

Exemples

Exemple #1 Exemple avec hash_hmac_file()

<?php
/* Crée un fichier pour calculer son empreinte numérique */
file_put_contents('exemple.txt''Le rapide goupil brun sauta par dessus le chien paresseux.');

echo 
hash_hmac_file('md5''exemple.txt''secret');
?>

L'exemple ci-dessus va afficher :

0d68e079ae8a5d364df207637e4f6860

Voir aussi

  • hash_hmac_algos() - Return a list of registered hashing algorithms suitable for hash_hmac
  • hash_hmac() - Génère une valeur de clé de hachage en utilisant la méthode HMAC
  • hash_file() - Génère une valeur de hachage en utilisant le contenu d'un fichier donné