PasswordFactory Class Reference

Factory class for creating and checking Password objects. More...

Public Member Functions
	__construct (array $config=[], string $default='')
	Most of the time you'll want to use MediaWikiServices::getInstance()->getPasswordFactory instead.
	getDefaultType ()
	Get the default password type.
	getTypes ()
	Get the list of types of passwords.
	init (Config $config)
	needsUpdate (Password $password)
	Determine whether a password object needs updating.
	newFromCiphertext (?string $hash)
	Create a new Hash object from an existing string hash.
	newFromPlaintext (?string $password, Password $existing=null)
	Create a new Hash object from a plaintext password.
	newFromType (string $type)
	Make a new default password of the given type.
	register (string $type, array $config)
	Register a new type of password hash.
	setDefaultType (string $type)
	Set the default password type.

Static Public Member Functions
static	generateRandomPasswordString (int $minLength=10)
	Generate a random string suitable for a password.
static	newInvalidPassword ()
	Create an InvalidPassword.

Detailed Description

Factory class for creating and checking Password objects.

Since

1.24

Definition at line 32 of file PasswordFactory.php.

Constructor & Destructor Documentation

__construct()

PasswordFactory::__construct	(	array	$config = [],
		string	$default = '' )

Most of the time you'll want to use MediaWikiServices::getInstance()->getPasswordFactory instead.

Parameters

array	$config	Mapping of password type => config
string	$default	Default password type

See also

PasswordFactory::register

PasswordFactory::setDefaultType

Definition at line 62 of file PasswordFactory.php.

References $type, and setDefaultType().

Member Function Documentation

generateRandomPasswordString()

static PasswordFactory::generateRandomPasswordString ( int $minLength = 10 )

static

Generate a random string suitable for a password.

Parameters

int

$minLength

Minimum length of password to generate

Returns

string

Definition at line 230 of file PasswordFactory.php.

getDefaultType()

PasswordFactory::getDefaultType

(

)

Get the default password type.

Returns

string

Definition at line 106 of file PasswordFactory.php.

getTypes()

PasswordFactory::getTypes

(

)

Get the list of types of passwords.

Returns

array[]

Definition at line 130 of file PasswordFactory.php.

init()

PasswordFactory::init

(

Config

$config

)

Deprecated

since 1.32 Initialize settings using the constructor

Initialize the internal static variables using the global variables

Parameters

Config

$config

Configuration object to load data from

Definition at line 117 of file PasswordFactory.php.

References $type.

needsUpdate()

PasswordFactory::needsUpdate

(

Password

$password

)

Determine whether a password object needs updating.

Check whether the given password is of the default type. If it is, pass off further needsUpdate checks to Password::needsUpdate.

Parameters

Password

$password

Returns

bool True if needs update, false otherwise

Definition at line 216 of file PasswordFactory.php.

newFromCiphertext()

PasswordFactory::newFromCiphertext

(

?string

$hash

)

Create a new Hash object from an existing string hash.

Parse the type of a hash and create a new hash object based on the parsed type. Pass the raw hash to the constructor of the new object. Use InvalidPassword type if a null hash is given.

Parameters

string | null

$hash

Existing hash or null for an invalid password

Returns

Password

Exceptions

PasswordError

If hash is invalid or type is not recognized

Definition at line 145 of file PasswordFactory.php.

newFromPlaintext()

PasswordFactory::newFromPlaintext	(	?string	$password,
		Password	$existing = null )

Create a new Hash object from a plaintext password.

If no existing object is given, make a new default object. If one is given, clone that object. Then pass the plaintext to Password::crypt().

Parameters

string | null	$password	Plaintext password, or null for an invalid password
Password | null	$existing	Optional existing hash to get options from

Returns

Password

Definition at line 189 of file PasswordFactory.php.

newFromType()

PasswordFactory::newFromType

(

string

$type

)

Make a new default password of the given type.

Parameters

string

$type

Existing type

Returns

Password

Exceptions

PasswordError

If hash is invalid or type is not recognized

Definition at line 169 of file PasswordFactory.php.

newInvalidPassword()

static PasswordFactory::newInvalidPassword ( )

static

Create an InvalidPassword.

Returns

InvalidPassword

Definition at line 246 of file PasswordFactory.php.

register()

PasswordFactory::register	(	string	$type,
		array	$config )

Register a new type of password hash.

Parameters

string	$type	Unique type name for the hash. Will be prefixed to the password hashes to identify what hashing method was used.
array	$config	Array of configuration options. 'class' is required (the Password subclass name), everything else is passed to the constructor of that class.

Definition at line 80 of file PasswordFactory.php.

setDefaultType()

PasswordFactory::setDefaultType

(

string

$type

)

Set the default password type.

This type will be used for creating new passwords when the type is not specified. Passwords of a different type will be considered outdated and in need of update.

Parameters

string

$type

Password hash type

Exceptions

InvalidArgumentException

If the type is not registered

Definition at line 94 of file PasswordFactory.php.

Referenced by __construct().

---

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

• includes/password/PasswordFactory.php