# hash

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

hash — Génère une valeur de hachage (empreinte numérique)

### Description

hash(
string `$algo`,
string `$data`,
bool `$binary` = `false`,
array `$options` = []
): string

### Liste de paramètres

`algo`

  Nom de l'algorithme de hachage sélectionné (par exemple : `"sha256"`). Pour une liste des algorithmes supportés voir hash_algos().

`data`

  Message à hacher.

`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 algorithmes dives 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.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `options` a été ajouté.
8.0.0 | hash() lance désormais une exception ValueError si l'`algo` est inconnu ; auparavant, `false` était retourné à la place.

### Exemples

Exemple #1 Exemple avec hash()

`<?php
echo hash('sha256', 'The quick brown fox jumped over the lazy dog.');
?>`

L'exemple ci-dessus va afficher :

    68b1282b91de2c054c36629cb8dd447f12f096d3e3c587978dc2248444633483

### Voir aussi

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