hash_hmac_file
(PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL hash >= 1.1)
hash_hmac_file — Berechnet einen Hash einer Datei mit Schlüssel unter Verwendung von HMAC
Beschreibung
string
$algo,string
$filename,string
$key,bool
$binary = false): string|false
Parameter-Liste
-
algo -
Der Name des gewählten Hash-Algorithmus (z. B. "md5", "sha256", "haval160,4", usw...). Für eine Liste der unterstützten Algorithmen, siehe hash_hmac_algos().
-
filename -
Die URL der Datei, die gehasht werden soll; fopen-Wrapper werden unterstützt.
-
key -
Ein geheimer Schlüssel für die Berechnung der HMAC-Variante des Hashes.
-
binary -
Ist dieser Parameter auf
truegesetzt, werden direkt Binärdaten zurückgegeben, andernfalls werden kleingeschriebene Hexadezimalziffern zurückgegeben.
Rückgabewerte
Gibt den berechneten Hash als Hexadezimalzahl zurück, außer
binary ist auf true gesetzt, in diesem Fall wird
die binäre Darstellung des Hashes zurückgegeben. Gibt false zurück, wenn
algo nicht bekannt oder eine nicht-kryptographische
Hash-Funktion ist, oder falls die Datei filename
nicht gelesen werden kann.
Changelog
| Version | Beschreibung |
|---|---|
| 7.2.0 | Die Verwendung von nicht-kryptografischen Hashfunktionen (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) ist nicht mehr möglich. |
Beispiele
Beispiel #1 hash_hmac_file()-Beispiel
<?php
/* Erstelle die Datei, deren Inhalt gehasht werden soll */
file_put_contents('example.txt', 'Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.');
echo hash_hmac_file('md5', 'example.txt', 'geheimnis');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
e949d0086c79cc6d67cf757bab4e5be8
Siehe auch
- hash_hmac_algos() - Return a list of registered hashing algorithms suitable for hash_hmac
- hash_hmac() - Berechnet einen Hash mit Schlüssel unter Verwendung von HMAC
- hash_file() - Berechnet den Hash des Inhalts einer Datei
