Laravel验证器怎么创建的?参数验证的一些疑与惑

2019-11-2011:05:43后端程序开发Comments2,625 views字数 4610阅读模式

验证器怎么创建的,谁创建的文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Laravel 文档调用验证器,除了通过控制器,还有就是通过Facades的方式创建验证器对象。Validator::make($data,$rule,$message)。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

config/ 中注册了'Validator' => Illuminate\Support\Facades\Validator::class。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

<?php

namespace Illuminate\Support\Facades;

/**
 * @see \Illuminate\Validation\Factory
 */
class Validator extends Facade
{
  /**
   * Get the registered name of the component.
   *
   * @return string
   */
  protected static function getFacadeAccessor()
  {
    return 'validator';
  }
}

从上面可以看出,Validator的实际实现类是容器中的validator对象,那这个validator对象是哪个?文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

<?php文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

namespace Illuminate\Foundation;
...
class Application extends Container implements ApplicationContract, HttpKernelInterface
{
  ...
  public function registerCoreContainerAliases()
  {
    foreach ([
      ...
      'validator'=> [
        \Illuminate\Validation\Factory::class,
        \Illuminate\Contracts\Validation\Factory::class
      ],
    ])
    ...
  }
  ...
}

可以看出,最终创建验证器是通过实现\Illuminate\Contracts\Validation\Factory接口的\Illuminate\Validation\Factory类创建的。再来看看,这个工厂类怎么创建实际的验证器的。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

//\Illuminate\Contracts\Validation\Factory 源码

protected function resolve(array $data, array $rules, array $messages, array $customAttributes)
{
  if (is_null($this->resolver)) {
    return new Validator(
      $this->translator,
      $data,
      $rules,
      $messages,
      $customAttributes
    );
  }

  return call_user_func(
    $this->resolver,
    $this->translator,
    $data,
    $rules,
    $messages,
    $customAttributes
  );
}

到这里,可以看出Laravel的验证器的创建都是通过特定的工厂类创建。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

如果需要自定义验证器类(比如我需要把的一些新功能迁移到的版本上),有两种方式:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

一,创建一个自定义的工厂类。然后在AppServiceProvider中重新绑定新的验证器工厂创建类;文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

二,AppServiceProvider中通过resolver方法设置工厂类的resolver属性,接管验证器的实例化,例如:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Validator::resolver(function($translator, $data, $rules, $messages, $customAttributes){
  return new ExtendValidator($translator, $data, $rules, $messages, $customAttributes);
});

如何自定义验证规则文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Laravel本身提供了很多通用的参数验证规则,但是对于一些特定的场景,还是需要提供验证规则的扩展。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Laravel验证规则的扩展有两种方式。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

1 通过extend方法扩展文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

//这是一个简单的参数比较的验证规则,Laravel中提供,Laravel中未提供
//验证规则如下: 'max_num'=>'gte:min',
Validator::extend('gte',function($attribute, $value, $parameters, $validator){
  if($value>=data_get($validator->getData(),$parameters[0]))
  {
    return true;
  }
  return false;
});
//\Illuminate\Contracts\Validation\Factory 源码
public function extend($rule, $extension, $message = null)
{
  $this->extensions[$rule] = $extension;

  if ($message) {
    $this->fallbackMessages[Str::snake($rule)] = $message;
  }
}
//\Illuminate\Validation\Validator 源码
protected function callExtension($rule, $parameters)
{
  $callback = $this->extensions[$rule];

  if (is_callable($callback)) {
    return call_user_func_array($callback, $parameters);
  } elseif (is_string($callback)) {
    return $this->callClassBasedExtension($callback, $parameters);
  }
}

protected function validateAttribute($attribute, $rule)
{
  ...
  $method = "validate{$rule}";
  if ($validatable && ! $this->$method($attribute, $value, $parameters, $this)) {
    $this->addFailure($attribute, $rule, $parameters);
  }
}

public function __call($method, $parameters)
{
  $rule = Str::snake(substr($method, 8));

  if (isset($this->extensions[$rule])) {
    return $this->callExtension($rule, $parameters);
  }

  throw new BadMethodCallException(sprintf(
    'Method %s::%s does not exist.', static::class, $method
  ));
}

Factory提供了extend方法用于扩展规则验证方法。所有的扩展规则最终都会被传到验证器中。验证器在验证参数的过程中,如果找到匹配的验证规则,则直接进行验证。否则调用魔术方法__call查找扩展验证函数。扩展函数返回布尔值,返回true则表示验证通过,返回false表示验证失败。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

2 通过自定义规则类扩展文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Laravel 中提供了Illuminate\Contracts\Validation\Rule接口,只有实现了这个接口的类都认为是符合的自定义验证规则类。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

<?php

namespace Illuminate\Contracts\Validation;

interface Rule
{
  /**
   * Determine if the validation rule passes.
   *
   * @param string $attribute
   * @param mixed $value
   * @return bool
   */
  public function passes($attribute, $value);

  /**
   * Get the validation error message.
   *
   * @return string
   */
  public function message();
}

自定义规则类需要实现的方法有passes方法,用于验证参数是否合法。message方法,用于提供验证失败的错误提示信息。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

使用自定义验证类,相对于extend方法扩展有一个很大的bug就是无法在自定义类中获取到当期的验证器对象。从而导致在当前扩展的验证规则中,只能过获取到需要验证的数据,而获取不到其他的字段数据,无法进行联合字段的验证。像上面比较两个字段的大小的验证规则就无法实现。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

如果想要通过自定义验证规则类实现上面两个字段大小比较的验证规则,则需要自定义验证类,修改validateUsingCustomRule方法,将当期验证器传入到自定义验证规则实例对象中去。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

protected function validateUsingCustomRule($attribute, $value, $rule)
{
  if(method_exists($rule, 'setValidator'))
  {
    $rule->setValidator($this);
  }
  return parent::validateUsingCustomRule($attribute,$value,$rule);
}

如何实现用当期类方法作为验证规则验证函数文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

像Yii2中,因为基本上所有的对象都有验证方法,所以很容易用当期类方法作为验证规则验证函数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

例如,一个验证规则如下,表示用当期类的validateMinNum对参数进行验证,那么,这样的一个功能,如何在Laravel中实现呢。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

['min_num'=>'validateMinNum']

方法1 通过自定义类实现 Laravel提供了ClosureValidationRule自定义验证类,用来添加回调函数的验证。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

例如文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

$rule = [
  'min'=>new ClosureValidationRule([$this,'checkv'])
];
$data = ['min'=>10];
$v = Validator::make($data,$rule);

方法2 通过extend方式实现文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

$rule = [
  'min'=>'checkv'
];
Validator::extend('checkv',[$this,'checkv']);

但是这种方式对验证器的影响是全局的。不建议使用。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

总结文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

通过以上源码的学习,可以看出Laravel验证器的创建都是用过验证器工厂类创建的。如果需要自定义验证器,可以通过修改验证器工厂类,或者设置验证器工厂类的resolver属性接管验证器的实例化。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

验证规则的扩展有两种方式,一种是通过extend方式实现。extend方式对验证器的影响是全局的,整个运行进程有效。可以获取到验证器本身,因此可以做多个字段关系的验证;另一种是通过自定义规则类实现。自定义规则了只对使用自定义规则类的验证有效。但是自定义规则类本身无法直接获取到验证器本身,不能够做多个字段关系的验证。如果需要实现,则需要使用自定义验证器,将验证器传入到验证规则中去。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

Laravel本身提供了ClosureValidationRule的验证规则用于处理回调函数验证规则。同时也可以使用extend方式进行回调函数的验证。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/17476.html

  • 本站内容整理自互联网,仅提供信息存储空间服务,以方便学习之用。如对文章、图片、字体等版权有疑问,请在下方留言,管理员看到后,将第一时间进行处理。
  • 转载请务必保留本文链接:https://www.cainiaoxueyuan.com/bc/17476.html

Comment

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

确定