Función PHP password_hash()
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
La salida es:
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
Ejemplo 2
La salida es:
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
Ejemplo 3
Ejemplo de configuración manual del valor de sal
La salida es:
$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.
Ejemplo 4
Ejemplo de password_hash() para encontrar el mejor cost
La salida es:
Appropriate Cost Found: 10
Ejemplo 5
Ejemplo de uso de Argon2:
La salida es:
Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0Otras extensiones