array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.password-verify.php', 1 => 'password_verify', 2 => 'Überprüft, ob ein Passwort und ein Hash zusammenpassen', ), 'up' => array ( 0 => 'ref.password.php', 1 => 'Passwort-Hashing-Funktionen', ), 'prev' => array ( 0 => 'function.password-needs-rehash.php', 1 => 'password_needs_rehash', ), 'next' => array ( 0 => 'book.rnp.php', 1 => 'Rnp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/password/functions/password-verify.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

password_verify

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

password_verify — Überprüft, ob ein Passwort und ein Hash zusammenpassen

Beschreibung

password_verify(#[\SensitiveParameter] string $password, string $hash): bool

Überprüft, ob ein Passwort und ein Hash zusammenpassen. password_verify() ist kompatibel zu crypt(). Daher können Passwort-Hashes, die mit crypt() erzeugt wurden, mit password_verify() verwendet werden.

Es ist zu beachten, dass password_hash() den Algorithmus, den Aufwand und den Salt als Teil des Hashes zurückgibt. Somit sind in Hash alle Informationen enthalten, die für die Überprüfung des Hashes erforderlich sind. Dies erlaubt es der Funktion, den Hash zu prüfen, ohne dass Informationen über den Salt oder den Algorithmus an anderer Stelle gespeichert werden müssen.

Diese Funktion ist vor Timing-Angriffen sicher.

Parameter-Liste

password

Das Passwort des Benutzers.

hash

Ein Hash, der durch password_hash() erzeugt wurde.

Rückgabewerte

Gibt true zurück, falls Passwort und Hash zusammenpassen, sonst false.

Beispiele

Beispiel #1 password_verify()-Beispiel

Dies ist ein vereinfachtes Beispiel; es wird empfohlen, ein korrektes Passwort bei Bedarf noch einmal zu hashen; siehe password_needs_rehash() für ein Beispiel.

<?php
// Siehe auch das password_hash()-Beispiel in diesem Kontext
$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';

if (password_verify('rasmuslerdorf', $hash)) {
echo 'Valides Passwort!';
} else {
echo 'Invalides Passwort.';
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Valides Passwort!

Siehe auch