array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.hash-hmac.php', 1 => 'hash_hmac', 2 => 'Генерирует хеш-код на основе ключа через метод HMAC', ), 'up' => array ( 0 => 'ref.hash.php', 1 => 'Функции Hash', ), 'prev' => array ( 0 => 'function.hash-hkdf.php', 1 => 'hash_hkdf', ), 'next' => array ( 0 => 'function.hash-hmac-algos.php', 1 => 'hash_hmac_algos', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/hash/functions/hash-hmac.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

hash_hmac

(PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL hash >= 1.1)

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

Описание

hash_hmac(
    string $algo,
    string $data,
    #[\SensitiveParameter] string $key,
    bool $binary = false
): string

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

algo

Название алгоритма хеширования (например, "sha256"). Список поддерживаемых алгоритмов возвращает функция 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');

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

d6f502c51167410320e6f85de2a66f04ed961c04396275cf808ed43828663a9d

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