[李景山php]每天laravel-20161004|Validator.php-4

    /**
     * Determine if it's a necessary presence validation.
     *
     * This is to avoid possible database type comparison errors.
     *
     * @param  string  $rule
     * @param  string  $attribute
     * @return bool
     */
    protected function hasNotFailedPreviousRuleIfPresenceRule($rule, $attribute)
    {//this function name it is to long
        //but can tell all about this function action
        // determine it is has not failed previousRule if Presence Rule
        return in_array($rule, ['Unique', 'Exists'])
                        ? ! $this->messages->has($attribute) : true;
        // if this rule is unique or exists, we need determine this attribute other wo just return it it ok!
    }// determine if it is necessary presence validation

    /**
     * Add a failed rule and error message to the collection.
     *
     * @param  string  $attribute
     * @param  string  $rule
     * @param  array   $parameters
     * @return void
     */
    protected function addFailure($attribute, $rule, $parameters)
    {
        $this->addError($attribute, $rule, $parameters);//add Error message

        $this->failedRules[$attribute][$rule] = $parameters;// insert this parameters into this failed Rules
    }// add a failed rule and error message into this collection

    /**
     * Add an error message to the validator's collection of messages.
     *
     * @param  string  $attribute
     * @param  string  $rule
     * @param  array   $parameters
     * @return void
     */
    protected function addError($attribute, $rule, $parameters)
    {
        $message = $this->getMessage($attribute, $rule);//first ,get all message about this rule

        $message = $this->doReplacements($message, $attribute, $rule, $parameters);// change this message into this right format message

        $this->messages->add($attribute, $message);// add it to this attribute
    }// this is a small wrap about addFailed rule

    /**
     * "Validate" optional attributes.
     *
     * Always returns true, just lets us put sometimes in rules.
     *
     * @return bool
     */
    protected function validateSometimes()
    {
        return true;
    }// Validate optional attributes.
    // return true;

    /**
     * "Break" on first validation fail.
     *
     * Always returns true, just lets us put "bail" in rules.
     *
     * @return bool
     */
    protected function validateBail()
    {
        return true;
    }// just return ok, in this break type

    /**
     * Stop on error if "bail" rule is assigned and attribute has a message.
     *
     * @param  string  $attribute
     * @return bool
     */
    protected function shouldStopValidating($attribute)
    {
        if (! $this->hasRule($attribute, ['Bail'])) {
            return false;
        }// no Bail switch no true,just return false,

        return $this->messages->has($attribute);// if has it,just return this message.
    }// determine this Bail messages

    /**
     * Validate that a required attribute exists.
     *
     * @param  string  $attribute
     * @param  mixed   $value
     * @return bool
     */
    protected function validateRequired($attribute, $value)
    {
        if (is_null($value)) {// no $value no ture
            return false;
        } elseif (is_string($value) && trim($value) === '') {
            return false;// a null string just return false
        } elseif ((is_array($value) || $value instanceof Countable) && count($value) < 1) {
            return false;// array or a structural and no value in this structural
        } elseif ($value instanceof File) {// if a file
            return (string) $value->getPath() != '';// can't be null
        }
        //in the end, we will found only this value parameters has value whatever it is,just return true.
        return true;
    }//Validate a required attribute is exists

    /**
     * Validate the given attribute is filled if it is present.
     *
     * @param  string  $attribute
     * @param  mixed   $value
     * @return bool
     */
    protected function validateFilled($attribute, $value)
    {
        if (array_key_exists($attribute, $this->data) || array_key_exists($attribute, $this->files)) {
            return $this->validateRequired($attribute, $value);// a filled just a required wrap
        }// two type

        return true;// normal it is true
    }// present : now
    // means this attribute just has a value

    /**
     * Determine if any of the given attributes fail the required test.
     *
     * @param  array  $attributes
     * @return bool
     */
    protected function anyFailingRequired(array $attributes)
    {
        foreach ($attributes as $key) {
            if (! $this->validateRequired($key, $this->getValue($key))) {
                return true;
            }
        }// same to ditto
        // ues a loop about this attribute

        return false;
    }//Determine if any of the given attributes fail the required test.

    /**
     * Determine if all of the given attributes fail the required test.
     *
     * @param  array  $attributes
     * @return bool
     */
    protected function allFailingRequired(array $attributes)
    {
        foreach ($attributes as $key) {
            if ($this->validateRequired($key, $this->getValue($key))) {
                return false;
            }
        }

        return true;
    }// all Fail just any ,the same , fool or stupid ?