Password.php

Go to the documentation of this file.

<?php
abstract class Password {
    protected $factory;
 
    protected $hash;
 
    protected $config;
 
    const MAX_HASH_SIZE = 255;
 
    final public function __construct( PasswordFactory $factory, array $config, $hash = null ) {
        if ( !isset( $config['type'] ) ) {
            throw new MWException( 'Password configuration must contain a type name.' );
        }
        $this->config = $config;
        $this->factory = $factory;
 
        if ( $hash !== null && strlen( $hash ) >= 3 ) {
            // Strip the type from the hash for parsing
            $hash = substr( $hash, strpos( $hash, ':', 1 ) + 1 );
        }
 
        $this->hash = $hash;
        $this->parseHash( $hash );
    }
 
    final public function getType() {
        return $this->config['type'];
    }
 
    protected function parseHash( $hash ) {
    }
 
    abstract public function needsUpdate();
 
    public function equals( $other ) {
        if ( !$other instanceof self ) {
            // No need to use the factory because we're definitely making
            // an object of the same type.
            $obj = clone $this;
            $obj->crypt( $other );
            $other = $obj;
        }
 
        return hash_equals( $this->toString(), $other->toString() );
    }
 
    public function toString() {
        $result = ':' . $this->config['type'] . ':' . $this->hash;
        $this->assertIsSafeSize( $result );
        return $result;
    }
 
    final protected function assertIsSafeSize( $hash ) {
        if ( strlen( $hash ) > self::MAX_HASH_SIZE ) {
            throw new PasswordError( "Password hash is too big" );
        }
    }
 
    abstract public function crypt( $password );
}