62 lines
1.9 KiB
PHP
62 lines
1.9 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
namespace Safe;
|
||
|
|
|
||
|
|
use Safe\Exceptions\HashException;
|
||
|
|
|
||
|
|
/**
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* @param string $algo Name of selected hashing algorithm (i.e. "sha256", "sha512", "haval160,4", etc..)
|
||
|
|
* See hash_algos for a list of supported algorithms.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* Non-cryptographic hash functions are not allowed.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* Non-cryptographic hash functions are not allowed.
|
||
|
|
* @param string $ikm Input keying material (raw binary). Cannot be empty.
|
||
|
|
* @param int $length Desired output length in bytes.
|
||
|
|
* Cannot be greater than 255 times the chosen hash function size.
|
||
|
|
*
|
||
|
|
* If length is 0, the output length
|
||
|
|
* will default to the chosen hash function size.
|
||
|
|
* @param string $info Application/context-specific info string.
|
||
|
|
* @param string $salt Salt to use during derivation.
|
||
|
|
*
|
||
|
|
* While optional, adding random salt significantly improves the strength of HKDF.
|
||
|
|
* @return string Returns a string containing a raw binary representation of the derived key
|
||
|
|
* (also known as output keying material - OKM);.
|
||
|
|
* @throws HashException
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
function hash_hkdf(string $algo, string $ikm, int $length = 0, string $info = '', string $salt = ''): string
|
||
|
|
{
|
||
|
|
error_clear_last();
|
||
|
|
$result = \hash_hkdf($algo, $ikm, $length, $info, $salt);
|
||
|
|
if ($result === false) {
|
||
|
|
throw HashException::createFromPhpError();
|
||
|
|
}
|
||
|
|
return $result;
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* @param \HashContext $hcontext Hashing context returned by hash_init.
|
||
|
|
* @param string $filename URL describing location of file to be hashed; Supports fopen wrappers.
|
||
|
|
* @param \HashContext|null $scontext Stream context as returned by stream_context_create.
|
||
|
|
* @throws HashException
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
function hash_update_file(\HashContext $hcontext, string $filename, ?\HashContext $scontext = null): void
|
||
|
|
{
|
||
|
|
error_clear_last();
|
||
|
|
$result = \hash_update_file($hcontext, $filename, $scontext);
|
||
|
|
if ($result === false) {
|
||
|
|
throw HashException::createFromPhpError();
|
||
|
|
}
|
||
|
|
}
|