openssl_password_verify

(PHP 8 >= 8.4.0)

openssl_password_verify — Verifica uma senha em relação a um hash usando a implementação Argon2 do OpenSSL

Descrição

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

Verifica que uma senha corresponde a um hash criado por openssl_password_hash().

Esta função só está disponível quando o PHP é compilado com suporte a OpenSSL que inclui Argon2 (HAVE_OPENSSL_ARGON2).

Parâmetros

algo

O algoritmo de hash de senha. Valores suportados: "argon2id" e "argon2i".

password

A senha do usuário.

hash

Um hash criado por openssl_password_hash().

Valor Retornado

Retorna true se houver correspondência entre o hash e a senha ou false caso contrário.

Erros/Exceções

Lança um ValueError se algo não for um dos valores suportados ("argon2i" ou "argon2id").

Registro de Alterações

Versão Descrição
8.4.0 Função adicionada.

Exemplos

Exemplo #1 Exemplo de openssl_password_verify()

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

if (openssl_password_verify('argon2id', 'my-secret-password', $hash)) {
echo 'Senha corresponde.';
} else {
echo 'Senha não corresponde.';
}
?>

Veja Também