[李景山php]每天laravel-20160917|BcryptHasher

<?php

namespace Illuminate\Hashing;

use RuntimeException;
use Illuminate\Contracts\Hashing\Hasher as HasherContract;
// more namespace
class BcryptHasher implements HasherContract
{// this BcryptHasher implements HasherContract
    /**
     * Default crypt cost factor.
     *
     * @var int
     */
    protected $rounds = 10;// Default crypt cost factor

    /**
     * Hash the given value.
     *
     * @param  string  $value
     * @param  array   $options
     * @return string
     *
     * @throws \RuntimeException
     */
    public function make($value, array $options = [])// one is value ,other is config or options
    {// Hash the given value. means to crypt this value
        $cost = isset($options[‘rounds‘]) ? $options[‘rounds‘] : $this->rounds;// get the rounds use like cost

        $hash = password_hash($value, PASSWORD_BCRYPT, [‘cost‘ => $cost]);// use a wrap function to finish this action
       // with three parameter ,value flag and config about cost

        if ($hash === false) {// if wrong throw Exception
            throw new RuntimeException(‘Bcrypt hashing not supported.‘);
        }
      // else return this value
        return $hash;
    }

    /**
     * Check the given plain value against a hash.
     *
     * @param  string  $value
     * @param  string  $hashedValue
     * @param  array   $options
     * @return bool
     */
    public function check($value, $hashedValue, array $options = [])
    {
        if (strlen($hashedValue) === 0) {
            return false;
        }// check len about this str

        return password_verify($value, $hashedValue);// use a wrap function
       // two parameter ,one is value and other is hashedValue
    }//check the given value

    /**
     * Check if the given hash has been hashed using the given options.
     *
     * @param  string  $hashedValue
     * @param  array   $options
     * @return bool
     */
    public function needsRehash($hashedValue, array $options = [])// determine thi value is been hashed
    {
        $cost = isset($options[‘rounds‘]) ? $options[‘rounds‘] : $this->rounds;

        return password_needs_rehash($hashedValue, PASSWORD_BCRYPT, [‘cost‘ => $cost]);
    }// a wrap function

    /**
     * Set the default password work factor.
     *
     * @param  int  $rounds
     * @return $this
     */
    public function setRounds($rounds)
    {
        $this->rounds = (int) $rounds;

        return $this;
    }// set Rounds
}