ilBcryptPhpPasswordEncoder Class Reference

Inheritance diagram for ilBcryptPhpPasswordEncoder:

Collaboration diagram for ilBcryptPhpPasswordEncoder:

Public Member Functions
	__construct (array $config=[])
	benchmarkCost (float $time_target=0.05)
	getName ()
	isSupportedByRuntime ()
	@inheritDoc More...
	getCosts ()
	setCosts (string $costs)
	encodePassword (string $raw, string $salt)
	@inheritDoc More...
	isPasswordValid (string $encoded, string $raw, string $salt)
	@inheritDoc More...
	requiresReencoding (string $encoded)
	@inheritDoc More...
Public Member Functions inherited from ilBasePasswordEncoder
	isSupportedByRuntime ()
	@inheritDoc More...
	requiresSalt ()
	@inheritDoc More...
	requiresReencoding (string $encoded)
	@inheritDoc More...
	encodePassword (string $raw, string $salt)
	Encodes the raw password. More...
	isPasswordValid (string $encoded, string $raw, string $salt)
	Checks a raw password against an encoded password. More...
	getName ()
	Returns a unique name/id of the concrete password encoder. More...
	requiresSalt ()
	Returns whether or not the encoder requires a salt. More...
	requiresReencoding (string $encoded)
	Returns whether or not the a encoded password needs to be re-encoded. More...
	isSupportedByRuntime ()
	Returns whether or not the encoder is supported by the runtime (PHP, HHVM, ...) More...

Protected Member Functions
	init ()
Protected Member Functions inherited from ilBasePasswordEncoder
	comparePasswords (string $knownString, string $userString)
	Compares two passwords. More...
	isPasswordTooLong (string $password)
	Checks if the password is too long. More...

Protected Attributes
	$costs = '08'

Additional Inherited Members
Data Fields inherited from ilBasePasswordEncoder
const	MAX_PASSWORD_LENGTH = 4096

Detailed Description

Definition at line 11 of file class.ilBcryptPhpPasswordEncoder.php.

Constructor & Destructor Documentation

__construct()

ilBcryptPhpPasswordEncoder::__construct

(

array

$config = []

)

Parameters

array

$config

Exceptions

ilPasswordException

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 22 of file class.ilBcryptPhpPasswordEncoder.php.

    {
        if (!empty($config)) {
            foreach ($config as $key => $value) {
                switch (strtolower($key)) {
                    case 'cost':
                        $this->setCosts($value);
                        break;
                }
            }
        }
 
        if (!isset($config['cost']) && static::class == self::class) {
            // Determine the costs only if they are not passed in constructor
            $this->setCosts((string) $this->benchmarkCost(0.05));
        }
 
        $this->init();
    }

References $config, benchmarkCost(), init(), and setCosts().

Here is the call graph for this function:

Member Function Documentation

benchmarkCost()

ilBcryptPhpPasswordEncoder::benchmarkCost

(

float

$time_target = 0.05

)

See also

http://php.net/manual/en/function.password-hash.php#example-984

Parameters

float

$time_target

Returns

int

Exceptions

ilPasswordException

Definition at line 55 of file class.ilBcryptPhpPasswordEncoder.php.

                                                             : int
    {
        $cost = 8;
 
        do {
            $cost++;
            $start = microtime(true);
            $encoder = new self(['cost' => (string) $cost]);
            $encoder->encodePassword('test', '');
            $end = microtime(true);
        } while (($end - $start) < $time_target && $cost < 32);
 
        return $cost;
    }

Referenced by __construct(), and ilBcryptPhpPasswordEncoderTest\testCostsCanBeDeterminedDynamically().

Here is the caller graph for this function:

encodePassword()

ilBcryptPhpPasswordEncoder::encodePassword	(	string	$raw,
		string	$salt
	)

@inheritDoc

Exceptions

ilPasswordException

Implements ilPasswordEncoder.

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 113 of file class.ilBcryptPhpPasswordEncoder.php.

                                                              : string
    {
        if ($this->isPasswordTooLong($raw)) {
            throw new ilPasswordException('Invalid password.');
        }
 
        return password_hash($raw, PASSWORD_BCRYPT, [
            'cost' => $this->getCosts()
        ]);
    }

References getCosts(), and ilBasePasswordEncoder\isPasswordTooLong().

Referenced by ilBcryptPhpPasswordEncoderTest\testReencodingIsDetectedWhenNecessary().

Here is the call graph for this function:

Here is the caller graph for this function:

getCosts()

ilBcryptPhpPasswordEncoder::getCosts

(

)

Returns

string

Definition at line 89 of file class.ilBcryptPhpPasswordEncoder.php.

                               : string
    {
        return $this->costs;
    }

References $costs.

Referenced by ilBcryptPasswordEncoder\encode(), encodePassword(), requiresReencoding(), ilBcryptPasswordEncoderTest\testCostsCanBeRetrievedWhenCostsAreSet(), and ilBcryptPhpPasswordEncoderTest\testCostsCanBeRetrievedWhenCostsAreSet().

Here is the caller graph for this function:

getName()

ilBcryptPhpPasswordEncoder::getName

(

)

Returns

string

Implements ilPasswordEncoder.

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 73 of file class.ilBcryptPhpPasswordEncoder.php.

                              : string
    {
        return 'bcryptphp';
    }

Referenced by ilBcryptPhpPasswordEncoderTest\testNameShouldBeBcryptPhp().

Here is the caller graph for this function:

init()

ilBcryptPhpPasswordEncoder::init ( )

protected

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 45 of file class.ilBcryptPhpPasswordEncoder.php.

                              : void
    {
    }

Referenced by __construct().

Here is the caller graph for this function:

isPasswordValid()

ilBcryptPhpPasswordEncoder::isPasswordValid	(	string	$encoded,
		string	$raw,
		string	$salt
	)

@inheritDoc

Implements ilPasswordEncoder.

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 127 of file class.ilBcryptPhpPasswordEncoder.php.

                                                                                : bool
    {
        return password_verify($raw, $encoded);
    }

isSupportedByRuntime()

ilBcryptPhpPasswordEncoder::isSupportedByRuntime

(

)

@inheritDoc

Reimplemented from ilBasePasswordEncoder.

Definition at line 81 of file class.ilBcryptPhpPasswordEncoder.php.

                                           : bool
    {
        return parent::isSupportedByRuntime() && version_compare(phpversion(), '5.5.0', '>=');
    }

requiresReencoding()

ilBcryptPhpPasswordEncoder::requiresReencoding

(

string

$encoded

)

@inheritDoc

Reimplemented from ilBasePasswordEncoder.

Reimplemented in ilBcryptPasswordEncoder.

Definition at line 135 of file class.ilBcryptPhpPasswordEncoder.php.

                                                        : bool
    {
        return password_needs_rehash($encoded, PASSWORD_BCRYPT, [
            'cost' => $this->getCosts()
        ]);
    }

References getCosts().

Referenced by ilBcryptPhpPasswordEncoderTest\testReencodingIsDetectedWhenNecessary().

Here is the call graph for this function:

Here is the caller graph for this function:

setCosts()

ilBcryptPhpPasswordEncoder::setCosts

(

string

$costs

)

Parameters

string

$costs

Exceptions

ilPasswordException

Definition at line 98 of file class.ilBcryptPhpPasswordEncoder.php.

                                            : void
    {
        if (!empty($costs)) {
            $costs = (int) $costs;
            if ($costs < 4 || $costs > 31) {
                throw new ilPasswordException('The costs parameter of bcrypt must be in range 04-31');
            }
            $this->costs = sprintf('%1$02d', $costs);
        }
    }

References $costs.

Referenced by __construct(), ilBcryptPasswordEncoderTest\testCostsCanBeRetrievedWhenCostsAreSet(), ilBcryptPhpPasswordEncoderTest\testCostsCanBeRetrievedWhenCostsAreSet(), ilBcryptPasswordEncoderTest\testCostsCanBeSetInRange(), ilBcryptPhpPasswordEncoderTest\testCostsCanBeSetInRange(), ilBcryptPasswordEncoderTest\testCostsCannotBeSetAboveRange(), ilBcryptPhpPasswordEncoderTest\testCostsCannotBeSetAboveRange(), ilBcryptPasswordEncoderTest\testCostsCannotBeSetBelowRange(), ilBcryptPhpPasswordEncoderTest\testCostsCannotBeSetBelowRange(), ilBcryptPasswordEncoderTest\testExceptionIsRaisedIfSaltIsMissingIsOnEncoding(), ilBcryptPasswordEncoderTest\testExceptionIsRaisedIfSaltIsMissingIsOnVerification(), and ilBcryptPhpPasswordEncoderTest\testReencodingIsDetectedWhenNecessary().

Here is the caller graph for this function:

Field Documentation

$costs

ilBcryptPhpPasswordEncoder::$costs = '08'

protected

Definition at line 16 of file class.ilBcryptPhpPasswordEncoder.php.

Referenced by getCosts(), and setCosts().

---

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

• Services/Password/classes/encoders/class.ilBcryptPhpPasswordEncoder.php