openssl_password_verify

(No version information available, might only be in Git)

openssl_password_verify — Verifica una contraseña frente a un hash usando la implementación de Argon2 de OpenSSL

Descripción

openssl_password_verify(string $algo, string $password, string $hash): bool

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).

Parámetros

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().

Valores devueltos

Devuelve true si la contraseña y el hash coinciden, false en caso contrario.

Errores/Excepciones

Lanza un ValueError si algo no es uno de los valores soportados ("argon2i" o "argon2id").

Historial de cambios

Versión	Descripción
8.4.0	Se ha añadido la función.

Ejemplos

Ejemplo #1 Ejemplo con openssl_password_verify()

<?php
$hash = openssl_password_hash('argon2id', 'my-secret-password');

if (openssl_password_verify('argon2id', 'my-secret-password', $hash)) {
    echo 'Password matches.';
} else {
    echo 'Password does not match.';
}
?>

Ver también

openssl_password_hash() - Crea un hash de contraseña usando la implementación de Argon2 de OpenSSL
password_verify() - Verifica que una contraseña coincide con un hash