password_verify

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

password_verify — Verifies that a password matches a hash

Опис

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

Verifies that the given hash matches the given password. password_verify() is compatible with crypt(). Therefore, password hashes created by crypt() can be used with password_verify().

Note that password_hash() returns the algorithm, cost and salt as part of the returned hash. Therefore, all information that's needed to verify the hash is included in it. This allows the verify function to verify the hash without needing separate storage for the salt or algorithm information.

This function is safe against timing attacks.

Параметри

password: Користувацький пароль.
hash: Геш, створений функцією password_hash().

Значення, що повертаються

Returns true if the password and hash match, or false otherwise.

Приклади

Приклад #1 password_verify() example

This is a simplified example; it is recommended to rehash a correct password if necessary; see password_needs_rehash() for an example.

<?php
// See the password_hash() example to see where this came from.
$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';

if (password_verify('rasmuslerdorf', $hash)) {
    echo 'Password is valid!';
} else {
    echo 'Invalid password.';
}
?>

Поданий вище приклад виведе:

Password is valid!

Прогляньте також

password_needs_rehash() - Checks if the given hash matches the given options
password_hash() - Creates a password hash
sodium_crypto_pwhash_str_verify() - Verifies that a password matches a hash