diff --git a/reference/openssl/functions/openssl-password-hash.xml b/reference/openssl/functions/openssl-password-hash.xml new file mode 100644 index 000000000..9d7e250b8 --- /dev/null +++ b/reference/openssl/functions/openssl-password-hash.xml @@ -0,0 +1,183 @@ + + + + + openssl_password_hash + Crea un hash de contraseña usando la implementación de Argon2 de OpenSSL + + + + &reftitle.description; + + stringopenssl_password_hash + stringalgo + stringpassword + arrayoptions[] + + + Crea un hash de contraseña usando la implementación de Argon2 de OpenSSL. + Es una alternativa a password_hash que utiliza OpenSSL + como backend, lo que puede ofrecer aceleración por hardware en algunas + plataformas. + + + Esta función solo está disponible cuando PHP se compila con soporte de + OpenSSL que incluye Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + El algoritmo de hash de contraseña. Valores soportados: + "argon2id" y "argon2i". + + + + + password + + + La contraseña del usuario. + + + + + options + + + Un &array; asociativo de opciones. Claves soportadas: + + + memory_cost - Memoria máxima (en KiB) que puede + utilizarse para calcular el hash + + + time_cost - Tiempo máximo que puede tomar + calcular el hash + + + threads - Número de hilos a utilizar para + calcular el hash + + + + + + + + + + + &reftitle.returnvalues; + + Devuelve el hash de la contraseña como una &string;. + + + + + &reftitle.errors; + + Lanza un ValueError si algo + no es uno de los valores soportados + ("argon2i" o "argon2id"). + + + Lanza un Error si la operación de hashing falla + por una razón desconocida. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Se ha añadido la función. + + + + + + + + + &reftitle.examples; + + Ejemplo con <function>openssl_password_hash</function> + + +]]> + + &example.outputs.similar; + + + + + + <function>openssl_password_hash</function> con opciones personalizadas + + 65536, + 'time_cost' => 4, + 'threads' => 1, +]); +?> +]]> + + + + + + &reftitle.seealso; + + + openssl_password_verify + password_hash + + + + + + diff --git a/reference/openssl/functions/openssl-password-verify.xml b/reference/openssl/functions/openssl-password-verify.xml new file mode 100644 index 000000000..64145d5f0 --- /dev/null +++ b/reference/openssl/functions/openssl-password-verify.xml @@ -0,0 +1,148 @@ + + + + + openssl_password_verify + Verifica una contraseña frente a un hash usando la implementación de Argon2 de OpenSSL + + + + &reftitle.description; + + boolopenssl_password_verify + stringalgo + stringpassword + stringhash + + + Verifica que una contraseña coincida con un hash creado por + openssl_password_hash. + + + Esta función solo está disponible cuando PHP se compila con soporte de + OpenSSL que incluye Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + El algoritmo de hash de contraseña. Valores soportados: + "argon2id" y "argon2i". + + + + + password + + + La contraseña del usuario. + + + + + hash + + + Un hash creado por openssl_password_hash. + + + + + + + + + &reftitle.returnvalues; + + Devuelve &true; si la contraseña y el hash coinciden, &false; en caso contrario. + + + + + &reftitle.errors; + + Lanza un ValueError si algo + no es uno de los valores soportados + ("argon2i" o "argon2id"). + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Se ha añadido la función. + + + + + + + + + &reftitle.examples; + + Ejemplo con <function>openssl_password_verify</function> + + +]]> + + + + + + &reftitle.seealso; + + + openssl_password_hash + password_verify + + + + + +