class.ilUserPasswordEncoderFactory.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2014 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Services/User/exceptions/class.ilUserException.php';

class ilUserPasswordEncoderFactory
{
    protected $default_encoder;

    protected $encoders = array();

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

        $this->initEncoders($config);
    }

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

    protected function initEncoders(array $config)
    {
        $this->encoders = [];

        $encoders = $this->getValidEncoders($config);

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

    public function getDefaultEncoder()
    {
        return $this->default_encoder;
    }

    public function setDefaultEncoder($default_encoder)
    {
        $this->default_encoder = $default_encoder;
    }

    public function getEncoders()
    {
        return $this->encoders;
    }

    public function setEncoders(array $encoders)
    {
        $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;
        }
    }

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

    public function getEncoderByName($name, $get_default_on_mismatch = false)
    {
        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];
    }

    public function getFirstEncoderForEncodedPasswordAndMatchers(string $encoded, array $matchers) : \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());
    }
}