• 自定义验证器
    • 声明验证器

    自定义验证器

    常见的业务默认验证器就能解决，但是有些业务默认验证器是没法验证，此时就需要用户根据自己业务需求，定义满足自己业务的验证器。

    声明验证器

    声明验证器很简单

    • 定一个类实现 Swoft\Validator\Contract\ValidatorInterface 接口
    • 实现 validate 方法，里面可以定义自己的业务验证器逻辑
    • 使用 @Validator 注解标记这是一个验证器，此注解使用和功能和之前介绍完全一样

    如下定义了一个验证器，验证 start 开始时间不能大于 end 结束时间

    1. use Swoft\Validator\Annotation\Mapping\Validator;
    2. use Swoft\Validator\Contract\ValidatorInterface;
    3. use Swoft\Validator\Exception\ValidatorException;
    5. /**
    6.  * Class UserValidator
    7.  *
    8.  * @since 2.0
    9.  *
    10.  * @Validator(name="userValidator")
    11.  */
    12. class UserValidator implements ValidatorInterface
    13. {
    14.     /**
    15.      * @param array $data
    16.      * @param array $params
    17.      *
    18.      * @return bool
    19.      * @throws ValidatorException
    20.      */
    21.     public function validate(array &$data, array $params): bool
    22.     {
    23.         $start = $data['start'];
    24.         $end   = $data['end'];
    26.         if ($start > $end) {
    27.             throw new ValidatorException('开始不能大于结束时间');
    28.         }
    30.         return true;
    31.     }
    32. }

    验证方法详细介绍

    1. public function validate(array &$data, array $params): bool
    • $data 用户输入参数，通过对于的解析器，已解析成数组
    • $params 传递给验证器的参数，后续章节详细介绍

    验证成返回 true , 如果验证失败，抛出 Swoft\Validator\Exception\ValidatorException 异常，其它由框架处理。如果验证器里面需要修改参数值，可以直接修改，修改后获取值的地方会得到新的值。