<?php declare( strict_types=1 );
namespace KadenceWP\KadenceStarterTemplates;
use InvalidArgumentException;
use RuntimeException;
final class Hasher {
/**
* The hashing algorithm to use.
*
* If on PHP8.1+, we'll use xxh128.
*
* @var string
*/
private $algo;
/**
* @param string $algo The hashing algorithm to use.
*
* @see \hash_algos()
*/
public function __construct( string $algo = 'md5' ) {
$this->algo = $algo;
}
/**
* Create a hash from different types of data.
*
* @param string|object|array|int|float $data The data to hash.
* @param bool $binary Output in raw binary.
*
* @return string
*
* @throws InvalidArgumentException|RuntimeException
*/
public function hash( $data, bool $binary = false ): string {
if ( $data === null ) {
throw new InvalidArgumentException( '$data cannot be null.' );
}
$data = is_scalar( $data ) ? (string) $data : (string) json_encode( $data );
if ( strlen( $data ) <= 0 ) {
throw new RuntimeException( 'Cannot hash an empty data string. Perhaps JSON encoding failed?' );
}
return hash( $this->algo, $data, $binary );
}
}