Функция PHP pass_needs_rehash()

Автор：Eve Cole Время обновления：2024-12-28 11:24:01

Функция pass_hash() используется для проверки соответствия хеш-значения указанным параметрам.

Требования к версии PHP: PHP 5 >= 5.5.0, PHP 7.

грамматика

 bool pass_needs_rehash (строка $hash, int $algo [, массив $options])

Описание параметра:

хеш: значение хеш-функции, созданное функцией pass_hash().

algo: константа криптографического алгоритма, используемая для указания алгоритма, используемого при хешировании паролей.

options: ассоциативный массив, содержащий параметры. В настоящее время поддерживаются два параметра: соль, соль (строка помех), добавляемая при хешировании пароля, и стоимость, которая используется для указания количества уровней рекурсии алгоритма. Примеры этих двух значений можно найти на странице crypt(). Если этот параметр опущен, будет использоваться случайное значение соли и стоимость по умолчанию.

возвращаемое значение

Эта функция определяет, реализует ли указанное значение хеш-функции предоставленный алгоритм и параметры. В противном случае хэш-значение необходимо сгенерировать заново.

Пример

использование пароля_needs_rehash()

<?php $password = ' rasmuslerdorf ' ; $hash = ' $2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS ' ; // Параметр стоимости можно изменить при улучшении производительности оборудования. $options = array ( ' cost ' => 11 ) // Сверяем сохраненный хеш с открытым текстовым паролем ; если ( пароль_проверить ( $пароль , $хеш ) ) { // Проверяем, доступен ли новый алгоритм хеширования // Или изменения стоимости если ( password_needs_rehash ( $hash , PASSWORD_DEFAULT , $options ) ) { // Если да, создаем новый хеш, заменяя старый $newHash = пароль_хэш ( $пароль , PASSWORD_DEFAULT , $options ) } ; // Разрешаем пользователю войти в систему } ?>