hash_hmac_file
(PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL hash >= 1.1)
hash_hmac_file — Генерація хеш-коду на основі ключа, використовуючи метод HMAC та вміст отриманого файлу
Опис
hash_hmac_file( string $algo, string $filename, string $key, bool $binary = false): string|false
Список параметрів
algo
Ім'я вибраного алгоритму хешування (наприклад, "md5", "sha256", "haval160,4" тощо) Дивіться hash_hmac_algos() для отримання списку алгоритмів, що підтримуються.
filename
URL розташування файлу для хешування; Підтримуються обробники Fopen.
key
Загальний секретний ключ, який використовується для генерації HMAC хеш-коду.
binary
Когда установлено в**true**, виводить необроблені двійкові дані При false виводить дані у шістнадцятковому кодуванні в нижньому регістрі.
Значення, що повертаються
Повертає рядок, що містить обчислений хеш-код у шістнадцятковому кодуванні в нижньому регістрі. Якщо binaryзадан как**true**, то повертається хеш-код у вигляді бінарних даних. Повертає false, якщо файл filenameнедоступен для чтения.
Помилки
Викидає виняток ValueError, якщо параметр algo невідомий чи не є криптографічною хеш-функцією.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Тепер викидає виняток ValueError, якщо алгоритм algo невідомий чи не є криптографічною хеш-функцією; раніше натомість поверталося значення false |
| 7.2.0 | Заборонено використання некриптографічних хеш-функцій (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat). |
Приклади
Приклад #1 Приклад використання hash_hmac_file()****
Результат виконання наведеного прикладу:
bc83c8fabc807cabbbb087bf90c760888349b223b5ba0a35251f7b37b05bf9c9
Дивіться також
- hash_hmac_algos() - Повертає список зареєстрованих алгоритмів хешування, які застосовуються для hash_hmac
- hash_hmac() - Генерація хеш-коду на основі ключа, використовуючи метод HMAC
- hash_file() - Генерація хеш-значення, використовуючи вміст заданого файлу