array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.hash-file.php', 1 => 'hash_file', 2 => 'Berechnet den Hash des Inhalts einer Datei', ), 'up' => array ( 0 => 'ref.hash.php', 1 => 'Hash-Funktionen', ), 'prev' => array ( 0 => 'function.hash-equals.php', 1 => 'hash_equals', ), 'next' => array ( 0 => 'function.hash-final.php', 1 => 'hash_final', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/hash/functions/hash-file.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

hash_file

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

hash_file — Berechnet den Hash des Inhalts einer Datei

Beschreibung

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

Parameter-Liste

algo

Der Name des gewählten Hash-Algorithmus (z. B. "sha256"). Für eine Liste der unterstützten Algorithmen siehe hash_algos().

filename

Die URL der Datei, die gehasht werden soll; fopen()-Wrapper werden unterstützt.

binary

Ist dieser Parameter auf true gesetzt, werden direkt Binärdaten zurückgegeben, andernfalls werden kleingeschriebene Hexadezimalziffern zurückgegeben.

options

Ein Array mit Optionen für die verschiedenen Hash-Algorithmen. Derzeit wird von den MurmurHash-Varianten nur der Parameter "seed" unterstützt.

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. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 Der Parameter options wurde hinzugefügt.

Beispiele

Beispiel #1 hash_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_file('sha256', 'example.txt');
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

0b3a381e71cda8f3abe88b1dc3eb9aa2a53fa033e9802878edd1959c267281a2

Siehe auch