sodium_crypto_generichash_final

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_generichash_final — ハッシュ値を計算する

説明

sodium_crypto_generichash_final(string &$state, int $length = SODIUM_CRYPTO_GENERICHASH_BYTES): string

ストリーミングハッシュAPI の処理を完了させるメソッドです。

パラメータ

state: sodium_crypto_generichash_init() から返されたハッシュステート。
length: 出力の長さ

戻り値

ハッシュ値を返します。

例

例1 sodium_crypto_generichash_final() の例


<?php
$messages = [random_bytes(32), random_bytes(32), random_bytes(16)];
$state = sodium_crypto_generichash_init('', 32);
foreach ($messages as $message) {
    sodium_crypto_generichash_update($state, $message);
}

$final = sodium_crypto_generichash_final($state, 32);
var_dump(sodium_bin2hex($final));

$allAtOnce = sodium_crypto_generichash(implode('', $messages));
var_dump(sodium_bin2hex($allAtOnce));
?>

上の例の出力は、たとえば以下のようになります。

string(64) "a2939a9163cb7c796ec28e01028489e72475c136b2697ea59e3e760ab4a8ab20"
string(64) "a2939a9163cb7c796ec28e01028489e72475c136b2697ea59e3e760ab4a8ab20"

関連キーワード: 　計算, crypto, sodium, generichash, final, string, init, length, ハッシュ, 出力