sodium_crypto_generichash_final

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_generichash_finalComplete the hash

Description

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

The finalization method for the streaming generichash API.

Parameters

state

Hash state returned from sodium_crypto_generichash_init()

length

Output length.

Return Values

Cryptographic hash.

Examples

Example #1 sodium_crypto_generichash_final() example

<?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($state32);
var_dump(sodium_bin2hex($final));

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

The above example will output something similar to:

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