CoreFiles by mySites.guru
ChainedHandler.php111 lines, 2,728 bytes, from Joomla_4.2.0-Stable-Full_Package.zip
Raw History Compare with 4.1.5
md5
aaed8b964921d28aeeef63bd9217b086
sha1
f9df601860fcf6e2aac39d18636cee6ef2e63b53
sha256
1674880d40a85c952f87c2660ebd855d263e9983cf91ac1e511d2144de973075
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2017 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Authentication\Password;

use Joomla\Authentication\Password\HandlerInterface;

/**
 * Password handler supporting testing against a chain of handlers
 *
 * @since  4.0.0
 */
class ChainedHandler implements HandlerInterface, CheckIfRehashNeededHandlerInterface
{
    /**
     * The password handlers in use by this chain.
     *
     * @var    HandlerInterface[]
     * @since  4.0.0
     */
    private $handlers = [];

    /**
     * Add a handler to the chain
     *
     * @param   HandlerInterface  $handler  The password handler to add
     *
     * @return  void
     *
     * @since   4.0.0
     */
    public function addHandler(HandlerInterface $handler)
    {
        $this->handlers[] = $handler;
    }

    /**
     * Check if the password requires rehashing
     *
     * @param   string  $hash  The password hash to check
     *
     * @return  boolean
     *
     * @since   4.0.0
     */
    public function checkIfRehashNeeded(string $hash): bool
    {
        foreach ($this->handlers as $handler) {
            if ($handler instanceof CheckIfRehashNeededHandlerInterface && $handler->isSupported() && $handler->checkIfRehashNeeded($hash)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Generate a hash for a plaintext password
     *
     * @param   string  $plaintext  The plaintext password to validate
     * @param   array   $options    Options for the hashing operation
     *
     * @return  void
     *
     * @since   4.0.0
     * @throws  \RuntimeException
     */
    public function hashPassword($plaintext, array $options = [])
    {
        throw new \RuntimeException('The chained password handler cannot be used to hash a password');
    }

    /**
     * Check that the password handler is supported in this environment
     *
     * @return  boolean
     *
     * @since   4.0.0
     */
    public static function isSupported()
    {
        return true;
    }

    /**
     * Validate a password
     *
     * @param   string  $plaintext  The plain text password to validate
     * @param   string  $hashed     The password hash to validate against
     *
     * @return  boolean
     *
     * @since   4.0.0
     */
    public function validatePassword($plaintext, $hashed)
    {
        foreach ($this->handlers as $handler) {
            if ($handler->isSupported() && $handler->validatePassword($plaintext, $hashed)) {
                return true;
            }
        }

        return false;
    }
}

The same content is in 5 releases, Joomla 4.2.0-beta3 to 4.2.1-rc2. See them all, or every version of this file.