MediaWiki master
MWCryptHash Class Reference

Utility functions for generating hashes. More...

Static Public Member Functions

static hash ( $data, $raw=true)
 Generate a cryptographic hash value (message digest) for a string, making use of the best hash algorithm that we have available.
 
static hashAlgo ()
 Decide on the best acceptable hash algorithm we have available for hash()
 
static hashLength ( $raw=true)
 Return the byte-length output of the hash algorithm we are using in self::hash and self::hmac.
 
static hmac ( $data, $key, $raw=true)
 Generate a keyed cryptographic hash value (HMAC) for a string, making use of the best hash algorithm that we have available.
 

Static Protected Attributes

static string $algo = null
 The hash algorithm being used.
 
static int $hashLength
 The number of bytes outputted by the hash algorithm.
 

Detailed Description

Utility functions for generating hashes.

This is based in part on Drupal code as well as what we used in our own code prior to introduction of this class, by way of MWCryptRand.

Definition at line 13 of file MWCryptHash.php.

Member Function Documentation

◆ hash()

static MWCryptHash::hash ( $data,
$raw = true )
static

Generate a cryptographic hash value (message digest) for a string, making use of the best hash algorithm that we have available.

Parameters
string$data
bool$rawTrue to return binary data, false to return it hex-encoded
Returns
string A hash of the data

Definition at line 71 of file MWCryptHash.php.

References hash().

Referenced by hash().

◆ hashAlgo()

static MWCryptHash::hashAlgo ( )
static

Decide on the best acceptable hash algorithm we have available for hash()

Returns
string A hash algorithm

Definition at line 28 of file MWCryptHash.php.

◆ hashLength()

static MWCryptHash::hashLength ( $raw = true)
static

Return the byte-length output of the hash algorithm we are using in self::hash and self::hmac.

Parameters
bool$rawTrue to return the length for binary data, false to return for hex-encoded
Returns
int Number of bytes the hash outputs

Definition at line 55 of file MWCryptHash.php.

◆ hmac()

static MWCryptHash::hmac ( $data,
$key,
$raw = true )
static

Generate a keyed cryptographic hash value (HMAC) for a string, making use of the best hash algorithm that we have available.

Parameters
string$data
string$key
bool$rawTrue to return binary data, false to return it hex-encoded
Returns
string An HMAC hash of the data + key

Definition at line 84 of file MWCryptHash.php.

Member Data Documentation

◆ $algo

string MWCryptHash::$algo = null
staticprotected

The hash algorithm being used.

Definition at line 17 of file MWCryptHash.php.

◆ $hashLength

int MWCryptHash::$hashLength
staticprotected

The number of bytes outputted by the hash algorithm.

Definition at line 22 of file MWCryptHash.php.


The documentation for this class was generated from the following file: