hash_hmac
HMAC 方式を使用してハッシュ値を生成する
説明
string hash_hmac(
string $algo
,
string $data
,
#[\SensitiveParameter]string $key
,
bool $binary
= false
)
パラメータ
-
algo
-
選択したアルゴリズムの名前 (例: "sha256"
)。
サポートするアルゴリズムの一覧は hash_hmac_algos を参照ください。
注意:
暗号に適さないハッシュ関数は許可されません。
-
data
-
ハッシュするメッセージ。
-
key
-
HMAC 方式でのメッセージダイジェストを生成するために使用する
共有の秘密鍵。
-
binary
-
true
を設定すると、生のバイナリデータを出力します。
false
の場合は小文字の 16 進数値となります。
戻り値
binary
が true に設定されていない場合は、
メッセージダイジェストの計算結果を小文字の 16 進数値形式の文字列で
返します。もし true に設定されていた場合は、メッセージダイジェストが
そのままのバイナリ形式で返されます。
エラー / 例外
algo
が不明な場合や、
暗号に適さないハッシュ関数の場合、
ValueError がスローされます。
例
例1 hash_hmac の例
<?php
echo hash_hmac('sha256', 'The quick brown fox jumped over the lazy dog.', 'secret');
?>
9c5c42422b03f0ee32949920649445e417b2c634050833c5165704b825c2a53b
参考
- hash_hmac_algos
- hash_hmac_file
- hash_equals