openssl_password_verify

(PHP 8 >= 8.4.0)

openssl_password_verify — Проверяет соответствие пароля хешу при помощи Argon2 из OpenSSL

Описание

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

Проверяет, соответствует ли пароль хешу, который был создан функцией openssl_password_hash().

Функция доступна только тогда, когда PHP скомпилирован с поддержкой OpenSSL, которая включает Argon2 (HAVE_OPENSSL_ARGON2).

Список параметров

algo: Алгоритм хеширования пароля. Поддерживаемые значения: "argon2id" и "argon2i".
password: Пароль пользователя.
hash: Хеш, который создан функцией openssl_password_hash().

Возвращаемые значения

Возвращает true, если пароль и хеш совпадают, или false в противном случае.

Ошибки

Выбрасывает исключение ValueError, если значение параметра algo не входит в список поддерживаемых ("argon2i" или "argon2id").

Список изменений

Версия	Описание
8.4.0	Функция добавлена.

Примеры

Пример #1 Пример использования функции openssl_password_verify()

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

if (openssl_password_verify('argon2id', 'my-secret-password', $hash)) {
    echo 'Пароль совпадает.';
} else {
    echo 'Пароль не совпадает.';
}
?>

Смотрите также

openssl_password_hash() - Создаёт хеш пароля при помощи Argon2 из OpenSSL
password_verify() - Проверяет, соответствует ли пароль хешу