If you get incorrect false responses from password_verify when manually including the hash variable (eg. for testing) and you know it should be correct, make sure you are enclosing the hash variable in single quotes (') and not double quotes (").
PHP parses anything that starts with a $ inside double quotes as a variable:
<?php
// this will result in 'Invalid Password' as the hash is parsed into 3 variables of
// $2y, $07 and $BCryptRequires22Chrcte/VlQH0piJtjXl.0t1XkA8pw9dMXTpOq
// due to it being enclosed inside double quotes
$hash = "$2y$07$BCryptRequires22Chrcte/VlQH0piJtjXl.0t1XkA8pw9dMXTpOq";
// this will result in 'Password is valid' as variables are not parsed inside single quotes
$hash = '$2y$07$BCryptRequires22Chrcte/VlQH0piJtjXl.0t1XkA8pw9dMXTpOq';
if (password_verify('rasmuslerdorf', $hash)) {
echo 'Password is valid!';
} else {
echo 'Invalid password.';
}
?>
password_verify
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
password_verify — Verifies that a password matches a hash
Description
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.
Parameters
-
password -
The user's password.
-
hash -
A hash created by password_hash().
Return Values
Returns true if the password and hash match, or false otherwise.
Examples
Example #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$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a';
if (password_verify('rasmuslerdorf', $hash)) {
echo 'Password is valid!';
} else {
echo 'Invalid password.';
}
?>The above example will output:
Password is valid!
See Also
- password_needs_rehash() - Checks if the given hash matches the given options
- password_hash() - Creates a password hash
- » userland implementation
- sodium_crypto_pwhash_str_verify() - Verifies that a password matches a hash
add a note
User Contributed Notes 5 notes
Anonymous ¶
10 years ago
Vasil Toshkov ¶
11 years ago
This function can be used to verify hashes created with other functions like crypt(). For example:
<?php
$hash = '$1$toHVx1uW$KIvW9yGZZSU/1YOidHeqJ/';
if (password_verify('rasmuslerdorf', $hash)) {
echo 'Password is valid!';
} else {
echo 'Invalid password.';
}
// Output: Password is valid!
?>
chris at weeone dot de ¶
8 years ago
The function password_verify() uses constant time. This makes it safe against timing attacks. Don't use crypt($password_database) === crypt($password_given_by_login), since there is no protection against timing attacks!
If you don't want to use password_verify(), then have a look at hash_equals(), which also runs a timing attack safe string comparison.
omidbahrami1990 at gmail dot com ¶
6 years ago
This Is The Most Secure Way To Keep Your Password Safe With PHP 7 ,
Even When Your DataBase Has Been Hacked ,
It Will Be Almost Impossible To Retrieve Your Password .
--------------------------------------------------------
--- When A User Wants To Sign Up ---
1 ---> Get Input From User Which Is The User`s Password
1 ---> Hash The Password
2 ---> Store The Hashed Password In Your DataBase
--------------------------------------------------------
<?php
$hashed_password = password_hash($_POST["password"],PASSWORD_DEFAULT);
// $_POST["password"] ---> Is The User`s Input
// $hashed_password ---> Is The Hashed Password You Can Store In Your DataBase
?>
--------------------------------------------------------
--- When A User Wants To Sign In ---
1 ---> Get Input From User Which Is The User`s Password
2 ---> Fetch The Hashed Password From Your Database
3 ---> Compare The User`s Input And The Hashed Password
--------------------------------------------------------
<?php
if(password_verify($_POST["password"],$hashed_password))
echo "Welcome";
else
echo "Wrong Password";
// $_POST["password"] ---> Is The User`s Input
// $hashed_password ---> Is The Hashed Password You Have Fetched From DataBase
?>
suit at rebell dot at ¶
11 years ago
As Vasil Toshkov stated, password_verify() can be used to verify a password created by crypt() or password_hash()
That is because passwords created by password_hash() also use the C crypt sheme
If you want to verify older plain MD5-Hashes you just need to prefix them with $1$
See https://en.wikipedia.org/wiki/Crypt_(C) for more information.
