gookit/validate 基于 Go 通用的数据验证与过滤库

Go 通用的数据验证与过滤库，使用简单，内置大部分常用验证器、过滤器，支持自定义消息、字段翻译。

• 支持验证 Map Struct Request（Form，JSON，url.Values, UploadedFile）数据
• 简单方便，支持前置验证检查, 支持添加自定义验证器
• 支持将规则按场景进行分组设置，不同场景验证不同的字段
• 支持在进行验证前对值使用过滤器进行净化过滤
• 已经内置了超多（>70 个）常用的验证器
• 方便的获取错误信息，验证后的安全数据获取(只会收集有规则检查过的数据)
• 支持自定义每个验证的错误消息，字段翻译，消息翻译(内置en zh-CN zh-TW)
• 完善的单元测试，测试覆盖率 > 90%

受到 albrow/forms asaskevich/govalidator inhere/php-validate 这些项目的启发，非常感谢它们。

验证结构体（Struct）

结构体可以实现 3 个接口方法，方便做一些自定义：

• ConfigValidation(v *Validation) 将在创建验证器实例后调用
• Messages() map[string]string 可以自定义验证器错误消息
• Translates() map[string]string 可以自定义字段映射/翻译

v1.2.1 更新:

• 支持通过结构体tag配置字段映射，默认读取 json 标签的值
• 支持通过结构体的 message tag 配置错误消息

package main

import (
  "fmt"
  "time"

  "github.com/gookit/validate"
)

// UserForm struct
type UserForm struct {
  Name     string    `validate:"required|minLen:7"`
  Email    string    `validate:"email" message:"email is invalid"`
  Age      int       `validate:"required|int|min:1|max:99" message:"int:age must int| min: age min value is 1"`
  CreateAt int       `validate:"min:1"`
  Safe     int       `validate:"-"`
  UpdateAt time.Time `validate:"required"`
  Code     string    `validate:"customValidator"` // 使用自定义验证器
}

// CustomValidator 定义在结构体中的自定义验证器
func (f UserForm) CustomValidator(val string) bool {
  return len(val) == 4
}

// Messages 您可以自定义验证器错误消息
func (f UserForm) Messages() map[string]string {
  return validate.MS{
    "required": "oh! the {field} is required",
    "Name.required": "message for special field",
  }
}

// Translates 你可以自定义字段翻译
func (f UserForm) Translates() map[string]string {
  return validate.MS{
    "Name": "用户名称",
    "Email": "用户Email",
  }
}

func main() {
  u := &UserForm{
    Name: "inhere",
  }
  
  // 创建 Validation 实例
  v := validate.Struct(u)
  // v := validate.New(u)

  if v.Validate() { // 验证成功
    // do something ...
  } else {
    fmt.Println(v.Errors) // 所有的错误消息
    fmt.Println(v.Errors.One()) // 返回随机一条错误消息
    fmt.Println(v.Errors.Field("Name")) // 返回该字段的错误消息
  }
}

验证Map数据

package main

import "fmt"
import "time"
import "github.com/gookit/validate"

func main()  {
  m := map[string]interface{}{
    "name":  "inhere",
    "age":   100,
    "oldSt": 1,
    "newSt": 2,
    "email": "some@email.com",
  }

  v := validate.Map(m)
  // v := validate.New(m)
  v.AddRule("name", "required")
  v.AddRule("name", "minLen", 7)
  v.AddRule("age", "max", 99)
  v.AddRule("age", "min", 1)
  v.AddRule("email", "email")
  
  // 也可以这样，一次添加多个验证器
  v.StringRule("age", "required|int|min:1|max:99")
  v.StringRule("name", "required|minLen:7")

    // 设置不同场景验证不同的字段
  // v.WithScenes(map[string]string{
  //   "create": []string{"name", "email"},
  //   "update": []string{"name"},
  // })
  
  if v.Validate() { // validate ok
    // do something ...
  } else {
    fmt.Println(v.Errors) // all error messages
    fmt.Println(v.Errors.One()) // returns a random error message text
  }
}

验证请求

传入 *http.Request，快捷方法 FromRequest() 就会自动根据请求方法和请求数据类型收集相应的数据

• GET/DELETE/... 等，会搜集 url query 数据
• POST/PUT/PATCH 并且类型为 application/json 会搜集JSON数据
• POST/PUT/PATCH 并且类型为 multipart/form-data 会搜集表单数据，同时会收集文件上传数据
• POST/PUT/PATCH 并且类型为 application/x-www-form-urlencoded 会搜集表单数据

package main

import (
  "fmt"
  "net/http"

  "github.com/gookit/validate"
)

func main()  {
  handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    data, err := validate.FromRequest(r)
    if err != nil {
      panic(err)
    }
    
    v := data.Create()
    // setting rules
    v.FilterRule("age", "int") // convert value to int
    
    v.AddRule("name", "required")
    v.AddRule("name", "minLen", 7)
    v.AddRule("age", "max", 99)
    
    if v.Validate() { // validate ok
      // do something ...
    } else {
      fmt.Println(v.Errors) // all error messages
      fmt.Println(v.Errors.One()) // returns a random error message text
    }
  })
  
  http.ListenAndServe(":8090", handler)
}

常用方法

快速创建 Validation 实例：

• Request(r *http.Request) *Validation
• JSON(s string, scene ...string) *Validation
• Struct(s interface{}, scene ...string) *Validation
• Map(m map[string]interface{}, scene ...string) *Validation
• New(data interface{}, scene ...string) *Validation

快速创建 DataFace 实例：

• FromMap(m map[string]interface{}) *MapData
• FromStruct(s interface{}) (*StructData, error)
• FromJSON(s string) (*MapData, error)
• FromJSONBytes(bs []byte) (*MapData, error)
• FromURLValues(values url.Values) *FormData
• FromRequest(r *http.Request, maxMemoryLimit ...int64) (DataFace, error)

通过 DataFace 创建 Validation

d := FromMap(map[string]interface{}{"key": "val"})
v := d.Validation()

Validation 常用方法：

• func (v *Validation) AtScene(scene string) *Validation 设置当前验证场景名
• func (v *Validation) Filtering() bool 应用所有过滤规则
• func (v *Validation) Validate() bool 应用所有验证和过滤规则
• func (v *Validation) SafeData() map[string]interface{} 获取所有经过验证的数据
• func (v *Validation) BindSafeData(ptr interface{}) error 将验证后的安全数据绑定到一个结构体

更多使用

全局选项

// GlobalOption settings for validate
type GlobalOption struct {
  // FilterTag name in the struct tags.
  FilterTag string
  // ValidateTag in the struct tags.
  ValidateTag string
  // StopOnError If true: An error occurs, it will cease to continue to verify
  StopOnError bool
  // SkipOnEmpty Skip check on field not exist or value is empty
  SkipOnEmpty bool
}

如何配置:

  // change global opts
  validate.Config(func(opt *validate.GlobalOption) {
    opt.StopOnError = false
    opt.SkipOnEmpty = false
  })

自定义错误消息

注册内置的语言消息

import "github.com/gookit/validate/locales/zhcn"

// for all Validation.
// NOTICE: must be register before on validate.New()
zhcn.RegisterGlobal()

v := validate.New()

// only for current Validation
zhcn.Register(v)

手动添加全局消息

validate.AddGlobalMessages(map[string]string{
    "minLength": "OO! {field} min length is %d",
})

为当前验证添加消息(仅本次验证有效)

v := validate.New(map[string]interface{}{
    "name": "inhere",
})
v.StringRule("name", "required|string|minLen:7|maxLen:15")

v.AddMessages(map[string]string{
    "minLength": "OO! {field} min length is %d",
    "name.minLen": "OO! username min length is %d",
})

结构体可以通过 Messages() 方法添加

// Messages you can custom validator error messages. 
func (f UserForm) Messages() map[string]string {
  return validate.MS{
    "required": "oh! the {field} is required",
    "Name.required": "message for special field",
  }
}

自定义验证器

validate 支持添加自定义验证器，并且支持添加 全局验证器 和 临时验证器 两种

• 全局验证器 全局有效，所有地方都可以使用
• 临时验证器 添加到当前验证实例上，仅当次验证可用
• 在结构体上添加验证方法。使用请看上面结构体验证示例中的 func (f UserForm) CustomValidator(val string) bool

注意：验证器方法必须返回一个 bool 表明验证是否成功。第一个参数是对应的字段值，如果有额外参数则自动追加在后面

添加全局验证器

你可以一次添加一个或者多个自定义验证器

  validate.AddValidator("myCheck0", func(val interface{}) bool {
    // do validate val ...
    return true
  })
  validate.AddValidators(M{
    "myCheck1": func(val interface{}) bool {
      // do validate val ...
      return true
    },
  })

添加临时验证器

同样，你可以一次添加一个或者多个自定义验证器

  v := validate.Struct(u)
  v.AddValidator("myFunc3", func(val interface{}) bool {
    // do validate val ...
    return true
  })
  v.AddValidators(M{
    "myFunc4": func(val interface{}) bool {
      // do validate val ...
      return true
    },
  })

内置验证器

几大类别：

• (为空)必填验证
• 类型验证
• 大小、长度验证
• 字段值比较验证
• 文件验证
• 日期验证
• 字符串检查验证
• 其他验证

驼峰式的验证器名称现在都添加了下划线式的别名。因此 endsWith 也可以写为 ends_with

提示

• intX 包含: int, int8, int16, int32, int64
• uintX 包含: uint, uint8, uint16, uint32, uint64
• floatX 包含: float32, float64

内置过滤器

Filters powered by：gookit/filter

Gookit 工具包

• gookit/ini INI配置读取管理，支持多文件加载，数据覆盖合并, 解析ENV变量, 解析变量引用
• gookit/rux Simple and fast request router for golang HTTP
• gookit/gcli Go的命令行应用，工具库，运行CLI命令，支持命令行色彩，用户交互，进度显示，数据格式化显示
• gookit/event Go实现的轻量级的事件管理、调度程序库, 支持设置监听器的优先级, 支持对一组事件进行监听
• gookit/cache 通用的缓存使用包装库，通过包装各种常用的驱动，来提供统一的使用API
• gookit/config Go应用配置管理，支持多种格式（JSON, YAML, TOML, INI, HCL, ENV, Flags），多文件加载，远程文件加载，数据合并
• gookit/color CLI 控制台颜色渲染工具库, 拥有简洁的使用API，支持16色，256色，RGB色彩渲染输出
• gookit/filter 提供对Golang数据的过滤，净化，转换
• gookit/validate Go通用的数据验证与过滤库，使用简单，内置大部分常用验证、过滤器
• gookit/goutil Go 的一些工具函数，格式化，特殊处理，常用信息获取等
• 更多请查看 https://github.com/gookit

参考项目

• https://github.com/albrow/forms
• https://github.com/asaskevich/govalidator
• https://github.com/go-playground/validator
• https://github.com/inhere/php-validate

github 地址：https://github.com/gookit/validate