README

基于 Hyperf EasyValidator

优点

• 根据注解自动生成Vo类，自动获取并转换request参数类型
• 支持框架数据验证器，自定义验证规则

注意

php >= 8.0

安装

composer require lujihong/easy-validator

使用示例

控制器

declare(strict_types=1);

namespace Api\Controller;

use Hyperf\EasyValidator\Annotation\Body;
use Hyperf\EasyValidator\Annotation\FormData;
use Hyperf\EasyValidator\Annotation\Query;
use Hyperf\EasyValidator\Annotation\Header;
use Api\Vo\Demo\DemoEditVo; //自动生成的Vo类

#[Controller(prefix: '/demo')]
class DemoController extends AbstractController
{
    #[
        PostMapping(path: "test"),
        FormData(key: "phone|手机号", rule: "required|phone"),
        FormData(key: "code|验证码", rule: "required|max:6")
    ]
    public function index()
    {

    }

    #[
        PutMapping(path: 'edit'),
        Header(key: 'Token|token', rule: 'required'),
        Body(key: 'test|测试', rule: 'required', fieldType: 'int'),
        Body(key: 'test1|测试1', rule: 'required', fieldType: 'string'),
    ]
    public function edit()
    {
        $vo = new DemoEditVo();、
        
        //从request请求中获取请求参数
        $vo->getAttributes();//获取所有属性，包含ip
        $vo->getIp();//获取Ip
        $vo->getTest();//获取测试字段值，已自动转换成int类型
        $vo->getTest1();//获取测试1字段值，已自动转换成string类型
        
        //自定义request参数值
        $changeVal = 2;
        $vo->setTest($changeVal);
        $vo->getTest();//此时值已变为2
        
        //设置其他自定义参数
        $vo->setOther(['foo_field' => '测试值']);
        $vo->getOther();//获取设置的其他值
    }

    #[
        PostMapping(path: 'fromData'),
        FormData(key: "phone|手机号", rule: "required|phone"),
        FormData(key: "code|验证码", rule: "required|max:6")
    ]
    public function fromData(): bool
    {

    }

    #[
        GetMapping(path: 'find/{id}/and/{in}'),
        Query(key: "id|测试id", rule: "required|numeric"),
        Query(key: "name|测试名称", rule: "required|test") //test为自定义验证规格
    ]
    public function find(int $id, float $in): array
    {
        return ['$id' => $id, '$in' => $in];
    }

}

Vo类

• fieldType，用于生成Vo类的类型限定，所有字段均不设置则不生成Vo类

支持的值为：string | array | bool | int | float | file

验证器

• key 格式：field|字段名称
• rule 验证规则

rule 支持hyperf框架所有验证

内置规则：phone、telephone、identity_card、crontab、class_exist、comma_separated

• 自定义验证规则

只需类名称上加上CustomValidationRule，并实现对应规则即可

use Hyperf\EasyValidator\Annotation\CustomValidationRule;

#[CustomValidationRule]
class DemoCustomValidationRule
{
    /**
     * 校验错误则返回错误信息, 正确则返回 true
     * @param $attribute
     * @param $value
     * @return bool|string
     */
    public function test($attribute, $value): bool|string
    {
        if (!preg_match('/^1[3456789]{1}\d{9}$/', trim((string)$value))) {
            return '格式不正确';
        }

        return true;
    }
}