PHP password_needs_rehash()-Funktion
PHP-Passwort-Hashing-Algorithmen
Die Funktion password_hash() wird verwendet, um festzustellen, ob ein Hash-Wert mit den angegebenen Optionen übereinstimmt.
PHP-Versionsanforderungen: PHP 5 >= 5.5.0, PHP 7
Syntax
bool password_needs_rehash ( string $hash , int $algo [, array $options ] )
Parameterbeschreibung:
- hash: Ein von password_hash() erzeugter Hash-Wert.
- algo: Eine Passwort-Algorithmus-Konstante, die verwendet wird, um den Algorithmus beim Hashen von Passwörtern anzugeben.
- options: Ein assoziatives Array mit Optionen. Derzeit werden zwei Optionen unterstützt: salt, das Salz (Störzeichenkette), das beim Hashen des Passworts hinzugefügt wird, und cost, das die Anzahl der Rekursionsschichten des Algorithmus angibt. Beispiele für diese beiden Werte finden sich auf der crypt()-Seite. Wenn nicht angegeben, werden ein zufälliger Salt-Wert und Standardkosten verwendet.
Rückgabewert
Diese Funktion prüft, ob der angegebene Hash-Wert den bereitgestellten Algorithmus und die Optionen implementiert. Wenn nicht, muss der Hash-Wert neu generiert werden.
Beispiele
password_needs_rehash() Verwendung
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
//Wenn sich die Hardware-Leistung verbessert, kann der cost-Parameter erneut geändert werden.
$options = array('cost' => 11);
//Überprüfen Sie den gespeicherten Hash gegen das Klartext-Passwort.
if (password_verify($password, $hash)) {
//Erkennen, ob es einen neueren verfügbaren Hashing-Algorithmus gibt.
//Oder sich die Kosten ändern.
if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
//Wenn ja, einen neuen Hash erstellen und den alten ersetzen.
$newHash = password_hash($password, PASSWORD_DEFAULT, $options);
}
//Den Benutzer anmelden.
}