Youloge.validate Webman 高级表单验证器(PHP7.2+)

Webman 表单验证器是：Github Youloge.Tool 的子函数之一，如果安装了webman.tool就不需要再安装webman.validate了。经过webman.validate 过滤处理后的表单，基本可以达到入库要求，可以大大简化逻辑处理。[2.0.0+ 版本进行了重写 现在处理可以处理更加复杂的表单且不需要进行多次验证，在一个验证规则中即可处理任意复杂度的数据]

• [新]支持自定义匿名函数处理
• [新]支持数据流式流转处理
• 支持数据链式预处理处理
• 支持对象和数组数据验证
• 支持自定义错误提示
• 支持字段过滤，仅返回指定验证字段
• 可以对任意复杂表单进行处理过滤转化并合并结果

项目地址

Youloge.Validate Star 我 如果对你的项目有帮助 欢迎打赏~

• 2.0.1 [2026-03-07] 新增流式处理 [M,N,Q],新增callable闭包自定义处理函数
• 1.4.2 [2025-11-11] 新增sprintf,format规则，格式化字符串
• 1.4.0 [2025-10-25] 优化required规则，允许0、'0'、false、[]、{}
• 1.3.3 [2025-08-14] 新增array和object数据类型
• 1.3.1 [2025-08-12] 默认数据类型与默认值：数据类型修复为一致
• 1.3.0 [2025-04-23] 添加array_is_list函数，兼容到 php7.2+
• 1.2.8 [2025-03-20] 基本数据类型int:100,float:1.02,bool:false,string:默认值 提供默认值支持

安装使用

composer require youloge/webman.validate

函数名称 useValidate()

使用说明

验证规则: |,:,,,#,[]

• | 分割多个规则
• : 规则参数 ,多个参数用逗号分隔
• # 自定义错误提示
• $return = useValidate($params,$rules,$filter=true)
• $params 验证数据
• $rules 验证规则
• $filter 是否过滤数据,剔除规则之外的数据在返回 默认 true
• 验证失败返回 ['err'=>400,'msg'=>'错误提示']
• 验证成功返回 处理过后的数据(filter)$params

参数说明

xss 过滤不仅会过滤 html 标签，还会过滤 ',",;,--,%,_,(,), 可以防止Mysql 注入

• =============================
• = 过滤规则分为预处理和验证规则 新增闭包函数
• =============================
• = 基本处理: required int bool float string join trim upper lower sprintf format xss html
• = 常用验证: email mobile url ip date time idcard regex test
• = 数字相关: min max between
• = 字符相关: start end digit alpha alphanum length
• = 取值相关: in not count
• = 闭包函数: function($field,$value){}
• =============================

简单示例：

$params = [
     'username' => 'admin',
     'password' => '123456',
];
$rules =[
     'username' => 'required|trim|lower|email', // 必填，去除空格，转小写，邮箱格式
     'password' => function($field,$value){
          // 验证不通过返回 `Exception` 即可
          if(count($value) < 8){
               throw new Exception("密码长度不足~");
          }
          // 验证通过 并处理数据
          return md5($value); 
     }
];

@['err'=>$err,'msg'=>$msg] = $data = useValidator($params,$rules,$filter=true);
if($err === 400) return json(['err'=>400,'msg'=>$msg]);

复杂示例：

请求数据：

{
  "title": "文章标题",
  "content": "文章内容",
  "type": 3,
  "status": "00000001",
  "share": 1,
  "price": "a12.34",
  "created": "2022-01-01 12:00:00",
  "tags": ["标签1", "标签2"],
  "info": {
    "origin": "https://www.youloge.com",
    "ip": "127.0.0.1"
  },
  "list": [
    {
      "name": "张三",
      "age": 18,
      "mail": "EMAIL100@qq.com"
    },
    {
      "name": "李四",
      "age": 20
    },
    {
      "name": "李四",
      "age": 20
    }
  ]
}

验证规则：

$rules =[
     // length:64,6,30 (不是书写错误 不区分变量数量 不区分变量前后)
     'title' => 'required|xss|length:64,6,30', // 必填，长度6-64 去除html去除 HTML 和 PHP 标签
     'content' => 'required|html', // 必填，转义html标签
     'type' =>'required|in:1,2,3', // 必填，只能是1,2,3,不能是其他值
     'status' => 'required|int|not:0,99,100', // 必填，并转换成整数，不能是0,99,100
     'share' => 'required|bool', // 必填，并转换成布尔值
     'price' => 'required|float|format:%.2f|max:100', // 必填，并转换成浮点数 并格式化保留2位小数 最大100
     'created' => 'required|date:Y-m-d H:i', // 必填，日期格式(默认为：Y-m-d H:i:s)
     // 'tags' => 'required|count:1,6', // 必填，需要1~6个标签 [`相同键 只生效最后一个哦`]
     // 'tags' =>['required|length:2,20'], //  数组的每个值需要2-20个字符 [`相同键 只生效最后一个哦`]
     // 'tags' =>'required|join:-', // 使用-符号连接 [`相同键 只生效最后一个哦`]
     // 当验证规则是数组且不止一个规则则可以写成流式处理(将上面针对tags的规则组成一个规则)
     'tags'=>['required|count:1,6',['required|length:2,20','required|join:@']],
     // 注意这个规则是[数组对象]，所以下面的规则会循环验证数组内的对象
     'list' => [
          [
               'name'=>'required|string', // 必填，并转换成字符串
               'age'=>'required|int', // 必填，并转换成整数
               'mail'=>'required|end:@qq.com', // 必填，必须以@qq.com结尾
          ]
     ],
     // 这个规则是[单对象]，所以下面的规则会验证对象
     'info' => [
          'origin'=>'required|url', // 必填，需要为url格式
          'ip'=>'required|ip', // 必填，需要为ip格式
     ]
];
$params = $request->all();
@['err'=>$err,'msg'=>$msg] = $data = useValidator($params,$rules,$filter=true);
if($err === 400){
     return json(['err'=>400,'msg'=>$msg]);
}

流式处理

之前想对一个字段进行复杂操作，需要写第一步，第二步，第三步...,现在直接可以写成一维数组形式，规则：['int:100'] 数组只有一个规则代表：数组按照改规则处理，当规则不止一个按照自动展开规则，再按照从左到右依次验证处理。

• 数组需要 1~6个标签
• 每个标签需要 至少2-20个字符
• 每个标签 是否包含违规字符
• 最终使用,符号连接成字符串，正式项目表单会比这还要复杂，现在可以像以下这么写。

$rule_one = ['label'=>'required|count:1,6']; // 验证整个 label字段 满足required|count:1,6即可
$rule_two = ['label'=>['length:2,20']]; // 循环验证 label字段 每个字段都验证 length:2,20
// 注意：数组规则(多个 大于1)时候： 字符串规则 数组符号[]包裹规则  
// 如果数组规则只有一个 那个它表示 对数组进行 循环验证 这是 V2 版本的新特性  
@['err'=>$err,'msg'=>$msg] = $data_one = useValidator($params,[
     'label'=>[
          'required|count:1,6', // 先验证 label 必填 在验证 数组长度 1-6 之间
          ['length:2,20'], // 验证 label数组每个元素的内容 长度 2-20 之间
          [function($field,$value){ // 验证 label数组每个元素的 内容
               if(useDetection($value)){
                    return $value;
               }
               throw new Exception("包含违禁词~");
          }],
          'join:,' // 对 label数组元素 使用 , 号连接
     ]
]);
if($err === 400){ return json(['err'=>400,'msg'=>$msg]); }
// 验证通过输出 是一个逗号连起来的长字符串

规则的配置是和输入表单 是对应的关系，验证器会预处理数据并交给后续过滤规则，所以碰到需要处理同一个键同时进行修改+验证的情况,进行多次拆分即可。