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 输出小写 16 进制字符串。

返回值

如果 binary 设置为 true，则返回原始二进制数据表示的信息摘要，否则返回 16 进制小写字符串格式表示的信息摘要。

错误／异常

如果 algo 未知或非加密散列函数，则抛出 ValueError 异常。

更新日志

版本 说明
8.0.0 如果 algo 未知或者非加密散列函数，现在将抛出 ValueError 异常；以前返回 false。
7.2.0 不再支持非加密的散列函数（adler32、crc32、crc32b、fnv132、fnv1a32、fnv164、fnv1a64、joaat）。

示例

示例 #1 hash_hmac() 示例

<?php
echo hash_hmac('sha256', 'The quick brown fox jumped over the lazy dog.', 'secret');
?>

以上示例会输出：

9c5c42422b03f0ee32949920649445e417b2c634050833c5165704b825c2a53b

参见