hash hmac()

hash_hmac

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

hash_hmac — Genererar ett nyckelbundet hashvärde med HMAC-metoden

Beskrivning

`hash_hmac(string $algo, string $data, #[\SensitiveParameter] string $key, bool $binary = false): string`

Parametrar

algo: Namnet på den valda hash-algoritmen (t.ex. "sha256"). För en lista över stödda algoritmer, se hash_hmac_algos().

Notering: Icke-kryptografiska hash-funktioner är inte tillåtna.

data: Meddelandet som ska hashas.

key: Delad hemlig nyckel som används för att generera HMAC-varianten av meddelandesammandraget.

binary: Om satt till true returneras råa binära data. false returnerar hexadecimala tecken i små bokstäver.

Returvärden

Returnerar en sträng som innehåller det beräknade meddelandesammandraget som hexadecimala tecken i små bokstäver, om inte binary är satt till true, i vilket fall den råa binära representationen av meddelandesammandraget returneras.

Fel/Undantag

Kastar ett ValueError-undantag om algo är okänt eller är en icke-kryptografisk hash-funktion.

Ändringslogg

Version	Beskrivning
8.0.0	Kastar nu ett ValueError-undantag om algo är okänt eller är en icke-kryptografisk hash-funktion; tidigare returnerades false istället.
7.2.0	Användning av icke-kryptografiska hash-funktioner (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) inaktiverades.

Exempel

Exempel #1 hash_hmac()-exempel

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

Ovanstående exempel kommer att ge följande resultat:

9c5c42422b03f0ee32949920649445e417b2c634050833c5165704b825c2a53b

Se även

• hash_hmac_algos() — Returnerar en lista över registrerade hash-algoritmer som passar för hash_hmac
• hash_hmac_file() — Genererar ett nyckelbundet hashvärde med HMAC-metoden och innehållet i en given fil
• hash_equals() — Säker jämförelse av strängar mot timingattacker