Inheritance diagram for ilUserPasswordEncoderFactory:

Collaboration diagram for ilUserPasswordEncoderFactory:

Public Member Functions
	__construct (array $config=array())

	getDefaultEncoder ()

	setDefaultEncoder ($default_encoder)

	getEncoders ()

	setEncoders (array $encoders)

	getSupportedEncoderNames ()

	getEncoderByName ($name, $get_default_on_mismatch=false)

	getFirstEncoderForEncodedPasswordAndMatchers (string $encoded, array $matchers)

Protected Member Functions
	getValidEncoders ($config)

	initEncoders (array $config)

Protected Attributes
	$default_encoder

	$encoders = array()

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilUserPasswordEncoderFactory::__construct ( array $config = array() )

Parameters

array $config

Definition at line 26 of file class.ilUserPasswordEncoderFactory.php.

References $config, $key, initEncoders(), and setDefaultEncoder().

     {
         if (!empty($config)) {
             foreach ($config as $key => $value) {
                 switch (strtolower($key)) {
                     case 'default_password_encoder':
                         $this->setDefaultEncoder($value);
                         break;
                 }
             }
         }
 
         $this->initEncoders($config);
     }

Here is the call graph for this function:

Member Function Documentation

◆ getDefaultEncoder()

ilUserPasswordEncoderFactory::getDefaultEncoder ( )

Returns: string

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

References $default_encoder.

Referenced by getEncoderByName(), and getFirstEncoderForEncodedPasswordAndMatchers().

     {
         return $this->default_encoder;
     }

Here is the caller graph for this function:

◆ getEncoderByName()

ilUserPasswordEncoderFactory::getEncoderByName	(	$name,
		$get_default_on_mismatch = `false`
	)

Parameters

string	$name
bool	$get_default_on_mismatch

Returns

Exceptions

Definition at line 123 of file class.ilUserPasswordEncoderFactory.php.

References $name, and getDefaultEncoder().

Referenced by getFirstEncoderForEncodedPasswordAndMatchers().

     {
         if (!isset($this->encoders[$name])) {
             if (!$get_default_on_mismatch) {
                 throw new \ilUserException(sprintf('The encoder "%s" was not configured.', $name));
             } elseif (!$this->getDefaultEncoder()) {
                 throw new \ilUserException('No default encoder specified, fallback not possible.');
             } elseif (!isset($this->encoders[$this->getDefaultEncoder()])) {
                 throw new \ilUserException("No default encoder found for name: '{$this->getDefaultEncoder()}'.");
             }
 
             return $this->encoders[$this->getDefaultEncoder()];
         }
 
         return $this->encoders[$name];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getEncoders()

ilUserPasswordEncoderFactory::getEncoders ( )

Returns: []

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

References $encoders.

Referenced by getFirstEncoderForEncodedPasswordAndMatchers(), and getSupportedEncoderNames().

     {
         return $this->encoders;
     }

Here is the caller graph for this function:

◆ getFirstEncoderForEncodedPasswordAndMatchers()

ilUserPasswordEncoderFactory::getFirstEncoderForEncodedPasswordAndMatchers	(	string	$encoded,
		array	$matchers
	)

Parameters

string	$encoded
array	$matchers	An key/value pair callback functions (accepting the encoded password) assigned to the respective encoder name

Returns

Exceptions

Definition at line 146 of file class.ilUserPasswordEncoderFactory.php.

References getDefaultEncoder(), getEncoderByName(), and getEncoders().

                                                                                                    : \ilPasswordEncoder
     {
         foreach ($this->getEncoders() as $encoder) {
             foreach ($matchers as $encoderName => $callback) {
                 if (
                     $encoder->getName() === $encoderName &&
                     is_callable($callback) && $callback($encoded) === true
                 ) {
                     return $encoder;
                 }
             }
         }
 
         return $this->getEncoderByName($this->getDefaultEncoder());
     }

Here is the call graph for this function:

◆ getSupportedEncoderNames()

ilUserPasswordEncoderFactory::getSupportedEncoderNames ( )

Returns: string[]

Definition at line 112 of file class.ilUserPasswordEncoderFactory.php.

References getEncoders().

     {
         return array_keys($this->getEncoders());
     }

Here is the call graph for this function:

◆ getValidEncoders()

ilUserPasswordEncoderFactory::getValidEncoders ( $config )

protected

Parameters

array $config

Returns: []

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

References $config.

Referenced by initEncoders().

                                                  : array
     {
         return [
             new \ilBcryptPhpPasswordEncoder($config),
             new \ilBcryptPasswordEncoder($config),
             new \ilMd5PasswordEncoder($config),
         ];
     }

Here is the caller graph for this function:

◆ initEncoders()

ilUserPasswordEncoderFactory::initEncoders ( array $config )

protected

Parameters

array $config

Definition at line 57 of file class.ilUserPasswordEncoderFactory.php.

References $encoders, and getValidEncoders().

Referenced by __construct().

     {
         $this->encoders = [];
 
         $encoders = $this->getValidEncoders($config);
 
         foreach ($encoders as $encoder) {
             if ($encoder->isSupportedByRuntime()) {
                 $this->encoders[$encoder->getName()] = $encoder;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDefaultEncoder()

ilUserPasswordEncoderFactory::setDefaultEncoder ( $default_encoder )

Parameters

string $default_encoder

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

References $default_encoder.

Referenced by __construct().

     {
         $this->default_encoder = $default_encoder;
     }

Here is the caller graph for this function:

◆ setEncoders()

ilUserPasswordEncoderFactory::setEncoders ( array $encoders )

Parameters

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

     {
         $this->encoders = array();
         foreach ($encoders as $encoder) {
             if (!($encoder instanceof \ilPasswordEncoder)) {
                 throw new \ilUserException(sprintf('One of the passed encoders is not valid: %s.', json_encode($encoder)));
             }
             $this->encoders[$encoder->getName()] = $encoder;
         }
     }