Función PHP password_hash()

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

La función password_hash() se utiliza para crear el hash de una contraseña.

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

Sintaxis

string password_hash ( string $password , int $algo [, array $options ] )

password_hash() crea un hash de contraseña utilizando un algoritmo hash unidireccional de suficiente fortaleza. password_hash() es compatible con crypt(). Por lo tanto, los hashes de contraseña creados por crypt() también se pueden usar con password_hash().

Algoritmos compatibles actualmente:

  • PASSWORD_DEFAULT- Usar el algoritmo bcrypt (predeterminado en PHP 5.5.0). Tenga en cuenta que esta constante cambiará a medida que PHP agregue algoritmos más fuertes. Por lo tanto, la longitud del resultado generado con esta constante variará en el futuro. Por eso, se recomienda que la columna de la base de datos donde se almacena el resultado pueda superar los 60 caracteres (preferiblemente 255 caracteres).
  • PASSWORD_BCRYPT- UsarCRYPT_BLOWFISHalgoritmo para crear el hash. Esto producirá un resultado compatible con el uso de "$2y$". El resultado será una cadena de 60 caracteres, o devolverácrypt().FALSE。
  • PASSWORD_ARGON2I- Usar el algoritmo de hash Argon2 para crear el hash.

Opciones compatibles con PASSWORD_BCRYPT:

  • salt (string) - Proporcionar manualmente el valor de sal (salt) para el hash de la contraseña. Esto evita que se genere una sal automáticamente.

    Si se omite este valor, password_hash() generará automáticamente una sal aleatoria para cada hash de contraseña. Esta es una operación intencionada.

    Nota: la opción de sal (salt) está obsoleta (deprecated) desde PHP 7.0.0. Ahora es mejor simplemente usar el valor de sal generado por defecto.

  • cost (integer) - Representa el coste usado por el algoritmo. En la página de crypt() hay ejemplos de valores de cost.

    Si se omite, el valor predeterminado es 10. Este cost es un buen punto de partida, pero quizás se pueda aumentar según el hardware.

Opciones compatibles con PASSWORD_ARGON2I:

  • memory_cost (integer) - Memoria máxima para calcular el hash Argon2 (en bytes). Valor predeterminado:PASSWORD_ARGON2_DEFAULT_MEMORY_COST。

  • time_cost (integer) - Tiempo máximo para calcular el hash Argon2. Valor predeterminado:PASSWORD_ARGON2_DEFAULT_TIME_COST。

  • threads (integer) - Número máximo de hilos para calcular el hash Argon2. Valor predeterminado:PASSWORD_ARGON2_DEFAULT_THREADS。

Descripción de parámetros:

  • password: Un valor hash creado por password_hash().

  • algo: Una constante de algoritmo de contraseña que indica el algoritmo al generar el hash de la contraseña.

  • options: Un array asociativo que contiene opciones. Actualmente se soportan dos opciones: salt, la sal (cadena de interferencia) añadida al generar el hash de la contraseña, y cost, que indica el número de capas recursivas del algoritmo. Ejemplos de estos dos valores se pueden encontrar en la página de crypt().

    Si se omite, se usará una sal aleatoria y el cost por defecto.

Valor de retorno

Devuelve la contraseña con hash, o FALSE en caso de fallo.

Ejemplo

Ejemplo 1

<?php /** * Queremos usar el algoritmo predeterminado para generar el hash de la contraseña * Actualmente es BCRYPT y producirá un resultado de 60 caracteres. * * Ten en cuenta que el algoritmo predeterminado puede cambiar con el tiempo, * por lo que el espacio de almacenamiento debe poder superar los 60 caracteres (255 es una buena opción).*/ echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT); ?>

La salida es:

$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a

Ejemplo 2

<?php /** * En este caso, aumentamos el cost a 12 para BCRYPT. * Ten en cuenta que hemos cambiado a PASSWORD_BCRYPT, que siempre producirá 60 caracteres.*/ $options = [ 'cost' => 12, ]; echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options); ?>

La salida es:

$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K

Ejemplo 3

Ejemplo de configuración manual del valor de sal

<?php /** * Ten en cuenta que el valor de sal aquí se genera aleatoriamente. * Nunca uses un valor de sal fijo o que no se genere aleatoriamente. * * En la gran mayoría de los casos, puedes dejar que password_hash genere automáticamente la sal aleatoria por ti.*/ $options = [ 'cost' => 11, 'salt' => mcrypt_create_iv(22, MCRYPT_DEV_URANDOM), ]; echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options); ?>

La salida es:

$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.

Ejemplo 4

Ejemplo de password_hash() para encontrar el mejor cost

<?php /** * Este ejemplo realiza una prueba de referencia (benchmark) en el servidor para detectar qué tan alto puede ser el cost * sin ralentizar notablemente el servidor. * 8-10 es un buen punto de partida, y cuanto más alto mejor si el servidor es lo suficientemente rápido. * El siguiente código apunta a ≤ 50 milisegundos (milliseconds), * adecuado para el manejo de inicios de sesión interactivos.*/ $timeTarget = 0.05; //50 milisegundos (milliseconds) $cost = 8; do { $cost++; $start = microtime(true); password_hash("test", PASSWORD_BCRYPT, ["cost" => $cost]); $end = microtime(true); } while (($end - $start) < $timeTarget); echo "Appropriate Cost Found: " . $cost; ?>

La salida es:

Appropriate Cost Found: 10

Ejemplo 5

Ejemplo de uso de Argon2:

<?php echo 'Argon2 hash: ' . password_hash('rasmuslerdorf', PASSWORD_ARGON2I); ?>

La salida es:

Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0

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

Otras extensiones