Technical API Documentation for the CryptoManana Framework
\
CryptoManana
AsymmetricEncryption
Compatibility
Core
Abstractions
Containers
DataStructures
DesignPatterns
ErrorHandling
MessageDigestion
MessageEncryption
Randomness
Interfaces
Containers
DataStructures
DesignPatterns
ErrorHandling
MessageDigestion
MessageEncryption
Randomness
Traits
CommonValidations
Containers
DataStructures
DesignPatterns
MessageDigestion
MessageEncryption
Randomness
CryptographicProtocol
DataStructures
Exceptions
Factories
Hashing
Randomness
SymmetricEncryption
Utilities

\CryptoManana\Core\Abstractions\MessageDigestionAbstractKeyedHashFunction

Class AbstractKeyedHashFunction - Abstraction for keyed hash classes.

Summary

Methods
Properties
Constants
setKey()
getKey()
hashData()
hashObject()
hashFile()
repetitiveHashData()
verifyHash()
__construct()
setSalt()
getSalt()
setSaltingMode()
getSaltingMode()
setDigestFormat()
getDigestFormat()
__debugInfo()
No public properties found
ALGORITHM_NAME
isFileSaltingForcingNativeHashing()
saltAtFront()
saltAtBack()
saltAtSpecial()
addSaltString()
changeOutputFormat()
$salt
$saltingMode
$digestFormat
$inFrontCases
$inBackCases
$inSpecialCases
$useNative
$key
N/A
No private methods found
No private properties found
N/A

Constants

ALGORITHM_NAME

ALGORITHM_NAME

The internal name of the algorithm.

Properties

$salt

$salt : string

The salt string property storage.

Type

string — The salting string value.

$saltingMode

$saltingMode : integer

The salting mode property storage.

Type

integer — The salting mode integer code value.

$digestFormat

$digestFormat : integer

The digest output format property storage.

Type

integer — The output format integer code value.

$inFrontCases

$inFrontCases : array

List of salting modes that add the salt at the front side of the input data.

Type

array — Salting mode codes.

$inBackCases

$inBackCases : array

List of salting modes that add the salt at the back side of the input data.

Type

array — Salting mode codes.

$inSpecialCases

$inSpecialCases : array

List of salting modes that use complex salt and input data manipulation procedures.

Type

array — Salting mode codes.

$useNative

$useNative : boolean

Flag to force native code polyfill realizations, if available.

Type

boolean — Flag to force native realizations.

$key

$key : string

The key string property storage.

Type

string — The digestion key string value.

Methods

setKey()

setKey(string  $key) : $this

Setter for the key string property.

Parameters

string $key

The digestion key string.

Throws

\Exception

Validation errors.

Returns

$this —

The hash algorithm object.

getKey()

getKey() : string

Getter for the key string property.

Returns

string —

The digestion key string.

hashData()

hashData(string  $data) : string

Calculates a hash value for the given data.

Parameters

string $data

The input string.

Throws

\Exception

Validation errors.

Returns

string —

The digest.

hashObject()

hashObject(object|\stdClass  $object) : string

Calculates a hash value for the serialized value of the given object.

Parameters

object|\stdClass $object

The object for hashing.

Throws

\Exception

Validation errors.

Returns

string —

The digest.

hashFile()

hashFile(string  $filename) : string

Calculates a hash value for the content of the given filename and location.

Parameters

string $filename

The full path and name of the file for hashing.

Throws

\Exception

Validation errors.

Returns

string —

The digest.

repetitiveHashData()

repetitiveHashData(string  $data, integer  $iterations = 2) : string

Calculates a hash value for the given data via repetitive/recursive digestion.

Parameters

string $data

The input string.
integer $iterations

The number of internal iterations to perform.

Throws

\Exception

Validation errors.

Returns

string —

The digest.

verifyHash()

verifyHash(string  $data, string  $digest) : boolean

Securely compares and verifies if a digestion value is for the given input data.

Parameters

string $data

The input string.
string $digest

The digest string.

Throws

\Exception

Validation errors.

Returns

boolean —

The result of the secure comparison.

__construct()

__construct()

Keyed hash algorithm constructor.

setSalt()

setSalt(string  $salt) : $this

Setter for the salt string property.

Parameters

string $salt

The salt string.

Throws

\Exception

Validation errors.

Returns

$this —

The hash algorithm object.

getSalt()

getSalt() : string

Getter for the salt string property.

Returns

string —

The salt string.

setSaltingMode()

setSaltingMode(integer  $saltingMode) : $this

Setter for the salting mode code property.

Parameters

integer $saltingMode

The salting mode code.

Throws

\Exception

Validation errors.

Returns

$this —

The hash algorithm object.

getSaltingMode()

getSaltingMode() : integer

Getter for the salt mode code property.

Returns

integer —

The salt mode code.

setDigestFormat()

setDigestFormat(integer  $digestFormat) : $this

Setter for the digest format code property.

Parameters

integer $digestFormat

The digest format code.

Throws

\Exception

Validation errors.

Returns

$this —

The hash algorithm object.

getDigestFormat()

getDigestFormat() : integer

Getter for the digest format code property.

Returns

integer —

The digest format code.

__debugInfo()

__debugInfo() : array

Get debug information for the class instance.

Returns

array —

Debug information.

isFileSaltingForcingNativeHashing()

isFileSaltingForcingNativeHashing() : boolean

Internal method for checking if native file hashing should be used by force.

Returns

boolean —

Is native hashing needed for the current salting mode.

saltAtFront()

saltAtFront(string  $data)

Internal method for grouping salting modes that add to the front of the input data.

Parameters

string $data

The input data for hashing.

saltAtBack()

saltAtBack(string  $data)

Internal method for grouping salting modes that add to the back of the input data.

Parameters

string $data

The input data for hashing.

saltAtSpecial()

saltAtSpecial(string  $data)

Internal method for grouping salting modes that use complex manipulations of the salt and input data.

Parameters

string $data

The input data for hashing.

addSaltString()

addSaltString(string  $data) : string

Internal method for adding the salt string to the input data via the chosen salting mode.

Parameters

string $data

The input data for hashing.

Returns

string —

The input data with proper salting.

changeOutputFormat()

changeOutputFormat(string  $digest) : string

Internal method for converting the digest's output format representation via the chosen format.

Parameters

string $digest

The output digest.

Returns

string —

The input data with proper salting.