Генерирует хеш-код на основе ключа через метод HMAC

Описание

hash_hmac(
    string $algo,
    string $data,
    string $key,
    bool $binary = false
): string

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

algo: Имя выбранного алгоритма хеширования (например, "md5", "sha256", "haval160,4" и т.д.) Смотрите описание функции hash_hmac_algos(), чтобы получить список поддерживаемых алгоритмов.
data: Сообщение для хеширования.
key: Общий секретный ключ, используемый для генерации HMAC хеш-кода.
binary: Когда установлено в true, выводит необработанные двоичные данные. При false выводит данные в шестнадцатеричной кодировке в нижнем регистре.

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

Функция возвращает строку, которая содержит вычисленный хеш-код в шестнадцатеричной кодировке в нижнем регистре. Если для параметра binary установили значение true, возвращается хеш-код в виде бинарных данных.

Ошибки

Функция выбрасывает исключение ValueError, если параметр algo неизвестен или не является криптографической хеш-функцией.

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

Версия	Описание
8.0.0	Теперь функция выбрасывает исключение ValueError, если алгоритм `algo` неизвестен или не является криптографической хеш-функцией; раньше вместо этого возвращалось значение `false`.
7.2.0	Запретили некриптографические хеш-функции (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat).

Примеры

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

<?php

echo hash_hmac('sha256', 'Наглый коричневый лисёнок прыгает вокруг ленивой собаки.', 'secret');

?>

Результат выполнения приведённого примера:

bc83c8fabc807cabbbb087bf90c760888349b223b5ba0a35251f7b37b05bf9c9

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

hash() - Генерирует хеш-значение (подпись сообщения)
hash_hmac_algos() - Возвращает список зарегистрированных алгоритмов хеширования, применимых для hash_hmac
hash_init() - Инициализирует контекст инкрементного хеширования
hash_hmac_file() - Генерирует хеш-значение на основе ключа через метод HMAC и содержимое файла
hash_equals() - Сравнивает строки без риска атаки по времени