Checks if the given hash matches the given options


(PHP 5 >= 5.5.0)

password_needs_rehashChecks if the given hash matches the given options


boolean password_needs_rehash ( string $hash , string $algo [, string $options ] )

This function checks to see if the supplied hash implements the algorithm and options provided. If not, it is assumed that the hash needs to be rehashed.



A hash created by password_hash().


A password algorithm constant denoting the algorithm to use when hashing the password.


An associative array containing options. Currently, two options are supported: salt, to provide a salt to use when hashing the password, and cost, which denotes the algorithmic cost that should be used. Examples of these values can be found on the crypt() page.

If omitted, the default cost will be used.

Return Values

Returns TRUE if the hash should be rehashed to match the given algo and options, or FALSE otherwise.

Customers Area | Contact us | Affiliates