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\HashingBcrypt

Class Bcrypt - The Bcrypt hashing algorithm object.

Summary

Methods
Properties
Constants
setAlgorithmicCost()
getAlgorithmicCost()
__construct()
__debugInfo()
hashData()
verifyHash()
setSalt()
getSalt()
setSaltingMode()
getSaltingMode()
setDigestFormat()
getDigestFormat()
No public properties found
ALGORITHM_MAXIMUM_OUTPUT
ALGORITHM_NAME
changeOutputFormat()
convertFormattedDigest()
fetchAlgorithmVariation()
fetchAlgorithmParameters()
saltAtFront()
saltAtBack()
saltAtSpecial()
addSaltString()
$digestFormat
$useNative
$salt
$saltingMode
$inFrontCases
$inBackCases
$inSpecialCases
$computationalCost
N/A
No private methods found
No private properties found
N/A

Constants

ALGORITHM_MAXIMUM_OUTPUT

ALGORITHM_MAXIMUM_OUTPUT

The internal maximum length in bytes of the raw output digest for the algorithm.

ALGORITHM_NAME

ALGORITHM_NAME

The internal name of the algorithm.

Properties

$digestFormat

$digestFormat : integer

The digest output format property storage.

Type

integer — The output format integer code value.

$useNative

$useNative : boolean

Flag to force native code polyfill realizations, if available.

Type

boolean — Flag to force native realizations.

$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.

$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.

$computationalCost

$computationalCost : integer

The digestion internal computational cost property storage.

Type

integer — The algorithmic cost value.

Methods

setAlgorithmicCost()

setAlgorithmicCost(integer  $cost) : $this

Setter for the computational cost property.

Parameters

integer $cost

The algorithmic cost.

Throws

\Exception

Validation errors.

Returns

$this —

The hash algorithm object.

getAlgorithmicCost()

getAlgorithmicCost() : integer

Getter for the computational cost property.

Returns

integer —

The algorithmic cost.

__construct()

__construct()

Password-based key derivation algorithm constructor.

__debugInfo()

__debugInfo() : array

Get debug information for the class instance.

Returns

array —

Debug information.

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.

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.

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.

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.

convertFormattedDigest()

convertFormattedDigest(string  $digest) : string

Internal method for converting a formatted digest to raw bytes.

Parameters

string $digest

The digest string.

Returns

string —

The raw bytes digest representation.

fetchAlgorithmVariation()

fetchAlgorithmVariation() : integer|string

Fetch the correctly formatted internal variation for digestion.

Returns

integer|string —

The chosen variation for password hashing.

fetchAlgorithmParameters()

fetchAlgorithmParameters() : array

Fetch the correctly formatted internal parameters for digestion.

Returns

array —

The chosen parameters for password hashing.

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.