Función PHP password_needs_rehash()

PHP 密码散列算法Algoritmo de hash de contraseñas de PHP

La función password_hash() se utiliza para detectar si el valor hash coincide con las opciones especificadas.

Requisitos de versión de PHP: PHP 5 >= 5.5.0, PHP 7

Sintaxis

bool password_needs_rehash ( string $hash , int $algo [, array $options ] )

Descripción de parámetros:

  • hash: un valor hash creado por password_hash().
  • algo: una constante de algoritmo de contraseña que se utiliza para indicar el algoritmo al aplicar hash a la contraseña.
  • options: un array asociativo que contiene opciones. Actualmente admite dos opciones: salt, la sal (cadena de interferencia) que se añade al aplicar hash a la contraseña, y cost, que indica el número de niveles de recursión del algoritmo. Ejemplos de estos dos valores se pueden encontrar en la página de crypt(). Si se omite, se utilizarán un valor de sal aleatorio y el cost predeterminado.

Valor de retorno

Esta función detecta si el valor hash especificado implementa el algoritmo y las opciones proporcionados. Si no es así, es necesario regenerar el valor hash.

Ejemplo

Uso de password_needs_rehash()

<?php $password = 'rasmuslerdorf'; $hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS'; //Cuando el rendimiento del hardware mejore, el parámetro cost puede modificarse nuevamente. $options = array('cost' => 11); //Verificar el hash almacenado con la contraseña en texto plano. if (password_verify($password, $hash)) { //Detectar si hay un algoritmo de hash más nuevo disponible. //o si el cost ha cambiado. if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) { //Si es así, cree un nuevo hash y reemplace el hash antiguo. $newHash = password_hash($password, PASSWORD_DEFAULT, $options); } //Iniciar la sesión del usuario. } ?>

PHP 密码散列算法Algoritmo de hash de contraseñas de PHP

Otras extensiones