hash

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

hashГенерирует хеш-значение (подпись сообщения)

Описание

hash(
    string $algo,
    string $data,
    bool $binary = false,
    array $options = []
): string

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

algo

Название выбранного алгоритма хеширования (то есть "md5", "sha256", "haval160,4" и т. д.). Список поддерживаемых алгоритмов даёт описание функции hash_algos().

data

Сообщение, которое требуется захешировать.

binary

Если для параметра установили значение true, функция выводит необработанные двоичные данные. Если false — функция выводит символы в шестнадцатеричной кодировке в нижнем регистре.

options

Массив опций для алгоритмов хеширования. Пока вариантами функций хеширования MurmurHash поддерживается только параметр "seed".

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

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

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

Версия Описание
8.1.0 Добавили параметр options.
8.0.0 Функция hash() теперь выбрасывает исключение ValueError, если алгоритм algo неизвестен; раньше вместо этого возвращалось значение false.

Примеры

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

<?php

echo hash('sha256', 'The quick brown fox jumped over the lazy dog.');

?>

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

68b1282b91de2c054c36629cb8dd447f12f096d3e3c587978dc2248444633483

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

  • hash_file() - Генерирует хеш-значение на основе содержимого файла
  • hash_hmac() - Генерирует хеш-код на основе ключа через метод HMAC
  • hash_init() - Инициализирует контекст инкрементного хеширования
  • md5() - Возвращает MD5-хеш строки
  • sha1() - Возвращает SHA1-хеш строки