Функция PHP password_needs_rehash()
Алгоритмы хеширования паролей в PHP
Функция password_hash() используется для определения того, соответствует ли хеш-значение указанным параметрам.
Требования к версии PHP: PHP 5 >= 5.5.0, PHP 7
Синтаксис
bool password_needs_rehash ( string $hash , int $algo [, array $options ] )
Описание параметров:
- hash: хеш-значение, созданное password_hash().
- algo: Константа алгоритма пароля, используемая для указания алгоритма при хешировании паролей.
- options: Ассоциативный массив, содержащий параметры. В настоящее время поддерживает два параметра: salt — соль (строка-помеха), добавляемая при хешировании пароля, и cost, указывающий количество уровней рекурсии алгоритма. Примеры этих двух значений можно найти на странице crypt(). Если опущено, будут использоваться случайное значение соли и cost по умолчанию.
Возвращаемое значение
Эта функция проверяет, соответствует ли указанное хеш-значение предоставленному алгоритму и параметрам. Если нет, хеш-значение необходимо создать заново.
Примеры
Использование password_needs_rehash()
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
//Когда производительность аппаратного обеспечения улучшится, параметр cost можно будет изменить снова.
$options = array('cost' => 11);
//Проверьте сохранённый хеш на соответствие паролю в открытом виде.
if (password_verify($password, $hash)) {
//Определите, доступен ли более новый алгоритм хеширования.
//Или изменилось значение cost.
if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
//Если это так, создайте новый хеш и замените старый.
$newHash = password_hash($password, PASSWORD_DEFAULT, $options);
}
//Авторизуйте пользователя.
}