[李景山php]每天laravel-20161012|Validator.php-12

/**
* Get the inline message for a rule if it exists.
*
* @param  string  $attribute
* @param  string  $lowerRule
* @param  array   $source
* @return string|null
*/
protected function getInlineMessage($attribute, $lowerRule, $source = null)
{//Get the inline message for a rule if it exists
$source = $source ?: $this->customMessages;// if has source ,just use it

$keys = ["{$attribute}.{$lowerRule}", $lowerRule];// get key ,i like this type to write a new array.

// First we will check for a custom message for an attribute specific rule
// message for the fields, then we will check for a general custom line
// that is not attribute specific. If we find either we'll return it.
foreach ($keys as $key) {// loop keys
foreach (array_keys($source) as $sourceKey) {// loop source key
if (Str::is($sourceKey, $key)) {// if it is a string
return $source[$sourceKey];// just return the source value, because it is right, and break it.
}
}
}// this is i know ,the un better function ,
}// the bigger strange method

/**
* Get the custom error message from translator.
*
* @param  string  $customKey
* @return string
*/
protected function getCustomMessageFromTranslator($customKey)
{// get the custom error message from the translator
$shortKey = str_replace('validation.custom.', '', $customKey);// use str replace to get the short key

$customMessages = Arr::dot(
(array) $this->translator->trans('validation.custom')
);// get the custom Messages

foreach ($customMessages as $key => $message) {// loop message
if ($key === $shortKey || (Str::contains($key, ['*']) && Str::is($key, $shortKey))) {
return $message;
}// or ,just return it
}

return $customKey;// return it
}

/**
* Get the proper error message for an attribute and size rule.
*
* @param  string  $attribute
* @param  string  $rule
* @return string
*/
protected function getSizeMessage($attribute, $rule)
{//Get the proper error message for an attribute and size rule.
$lowerRule = Str::snake($rule);// get a format rule

// There are three different types of size validations. The attribute may be
// either a number, file, or string so we will check a few things to know
// which type of value it is and return the correct line for that type.
$type = $this->getAttributeType($attribute);//get Attribute Type

$key = "validation.{$lowerRule}.{$type}";// combine a key

return $this->translator->trans($key);// return the translator key
}

/**
* Get the data type of the given attribute.
*
* @param  string  $attribute
* @return string
*/
protected function getAttributeType($attribute)
{// get the data type of the given attribute.
// We assume that the attributes present in the file array are files so that
// means that if the attribute does not have a numeric rule and the files
// list doesn't have it we'll just consider it a string by elimination.
if ($this->hasRule($attribute, $this->numericRules)) {
return 'numeric';// return a type
} elseif ($this->hasRule($attribute, ['Array'])) {
return 'array';// type is array
} elseif (array_key_exists($attribute, $this->files)) {
return 'file';// type a file
}

return 'string';// normal this is a string,
//every thing can be make like a sting
}

/**
* Replace all error message place-holders with actual values.
*
* @param  string  $message
* @param  string  $attribute
* @param  string  $rule
* @param  array   $parameters
* @return string
*/
protected function doReplacements($message, $attribute, $rule, $parameters)
{//replace all error message place-holders with actual values.
$value = $this->getAttribute($attribute);// value this get attribute

$message = str_replace(// str_replace  has a supper good type.
[':ATTRIBUTE', ':Attribute', ':attribute'],
[Str::upper($value), Str::ucfirst($value), $value],
$message
);

if (isset($this->replacers[Str::snake($rule)])) {// if isset this replacer
$message = $this->callReplacer($message, $attribute, Str::snake($rule), $parameters);
} elseif (method_exists($this, $replacer = "replace{$rule}")) {
$message = $this->$replacer($message, $attribute, $rule, $parameters);
}

return $message;// return message
}

/**
* Transform an array of attributes to their displayable form.
*
* @param  array  $values
* @return array
*/
protected function getAttributeList(array $values)
{//Transform an array of attributes to their display able form.
$attributes = [];// init this attributes

// For each attribute in the list we will simply get its displayable form as
// this is convenient when replacing lists of parameters like some of the
// replacement functions do when formatting out the validation message.
foreach ($values as $key => $value) {
$attributes[$key] = $this->getAttribute($value);
}

return $attributes;
}