Nathan
Posted on September 6, 2021
PHP offers a very powerful password_hash
function, which will create a one-way hash of a string. It's often used for hashing passwords and access tokens.
We can pass an algorithm to password_hash
, but I'll be focusing on PASSWORD_DEFAULT
, which is a built-in algorithm designed to change over time as stronger algorithms are developed.
If you want to read about the other built-in algorithms that PHP offers, the official password hashing documentation explains each of them.
Anyway, password_hash
is fairly straightforward. The first parameter is the string to hash (in this case, "dragon123"). The second parameter is the algorithm to hash the string with.
$password = 'dragon123';
$hash = password_hash($password, PASSWORD_DEFAULT);
// As of writing this, $hash returns this monstrous string:
// "$2y$10$WIj56IGASADOa26io1AzeuMRvp3SKdYu8saCU.6.1xDpnr3w6xECS"
Remember, the PASSWORD_DEFAULT
algorithm is subject to change over time, so this code might return a different result for you in the future.
Furthermore, I want to echo the official documentation's suggestion to ensure your hashed password database column supports strings of up to 255 characters in length, likely ensuring future compatibility.
Verifying hashed passwords with password_verify
Verifying a hashed password is just as simple, thanks to password_verify
.
The first parameter is the plaintext string to check, and the second parameter is the hashed string to check the first string against.
$password = 'dragon123';
$hash = '$2y$10$WIj56IGASADOa26io1AzeuMRvp3SKdYu8saCU.6.1xDpnr3w6xECS';
$result = password_verify($password, $hash);
This function will return a boolean, either true
or false
, depending on whether the first string is valid:
if ($result === true) {
echo "Successfully authenticated."
} else {
echo "Invalid password."
}
If dragon123
is passed, $result
will be true
. However, if dragon456
or something else is passed, $result
will be false
.
Conclusion
While this is certainly isn't state-of-the-art, it's a great step for most small websites and startups, that is at least certainly far ahead of using a custom salt (let alone storing passwords in plaintext).
Posted on September 6, 2021
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.