hash_hmac

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

    hash_hmac — Генерация хеш-кода на основе ключа, используя метод 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() - Сравнивает строки без риска атаки по времени
    To Top