Class AbstractPasswordHasher

Abstract password hashing class

Cake\Auth\AbstractPasswordHasher uses Cake\Core\InstanceConfigTrait

Direct known subclasses

Cake\Auth\DefaultPasswordHasher, Cake\Auth\FallbackPasswordHasher, Cake\Auth\WeakPasswordHasher
Abstract
Namespace: Cake\Auth
Located at Auth/AbstractPasswordHasher.php

Method Detail

__constructsource public

__construct( array $config [] )

Constructor

Parameters

array $config optional []
Array of config.

checksource abstract public

check( string|array $password , string $hashedPassword )

Check hash. Generate hash from user provided password string or data array and check against existing hash.

Parameters

string|array $password
Plain text password to hash or data array.
string $hashedPassword
Existing hashed password.

Returns

boolean
True if hashes match else false.

hashsource abstract public

hash( string|array $password )

Generates password hash.

Parameters

string|array $password
Plain text password to hash or array of data required to generate password hash.

Returns

string
Password hash

needsRehashsource public

needsRehash( string $password )

Returns true if the password need to be rehashed, due to the password being created with anything else than the passwords generated by this class.

Returns true by default since the only implementation users should rely on is the one provided by default in php 5.5+ or any compatible library

Parameters

string $password
The password to verify

Returns

boolean
bool

Methods used from Cake\Core\InstanceConfigTrait

_configDeletesource protected

_configDelete( string $key )

Delete a single config key

Parameters

string $key
Key to delete.

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

_configReadsource protected

_configRead( string|null $key )

Read a config variable

Parameters

string|null $key
Key to read.

Returns

mixed
mixed

_configWritesource protected

_configWrite( string|array $key , mixed $value , boolean|string $merge false )

Write a config variable

Parameters

string|array $key
Key to write to.
mixed $value
Value to write.
boolean|string $merge optional false
True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

configsource public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Usage

Reading the whole config:

$this->config();

Reading a specific value:

$this->config('key');

Reading a nested value:

$this->config('some.nested.key');

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array|null $key optional null
The key to get/set, or a complete array of configs.
mixed|null $value optional null
The value to set.
boolean $merge optional true
Whether to recursively merge or overwrite existing config, defaults to true.

Returns

mixed
Config value being read, or the object itself on write operations.

Throws

Cake\Core\Exception\Exception
When trying to set a key that is invalid.

configShallowsource public

configShallow( string|array $key , mixed|null $value null )

Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key
The key to set, or a complete array of configs.
mixed|null $value optional null
The value to set.

Returns

mixed
$this The object itself.

Properties summary

$_defaultConfigsource

protected array

Default config

These are merged with user-provided config when the object is used.

[]

Properties used from Cake\Core\InstanceConfigTrait

$_configsource

protected array

Runtime config

[]

$_configInitializedsource

protected boolean

Whether the config property has already been configured with defaults

false

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.1/class-Cake.Auth.AbstractPasswordHasher.html