name: 表单数据验证

sort: 9

表单验证是用于数据验证和错误收集的模块。

安装及测试

安装：

  1. go get github.com/beego/beego/v2/core/validation

测试：

  1. go test github.com/beego/beego/v2/core/validation

示例

直接使用示例：

  1. import (
  2.     "github.com/beego/beego/v2/core/validation"
  3.     "log"
  4. )
  6. type User struct {
  7.     Name string
  8.     Age int
  9. }
  11. func main() {
  12.     u := User{"man", 40}
  13.     valid := validation.Validation{}
  14.     valid.Required(u.Name, "name")
  15.     valid.MaxSize(u.Name, 15, "nameMax")
  16.     valid.Range(u.Age, 0, 18, "age")
  18.     if valid.HasErrors() {
  19.         // 如果有错误信息，证明验证没通过
  20.         // 打印错误信息
  21.         for _, err := range valid.Errors {
  22.             log.Println(err.Key, err.Message)
  23.         }
  24.     }
  25.     // or use like this
  26.     if v := valid.Max(u.Age, 140, "age"); !v.Ok {
  27.         log.Println(v.Error.Key, v.Error.Message)
  28.     }
  29.     // 定制错误信息
  30.     minAge := 18
  31.     valid.Min(u.Age, minAge, "age").Message("少儿不宜！")
  32.     // 错误信息格式化
  33.     valid.Min(u.Age, minAge, "age").Message("%d不禁", minAge)
  34. }

通过 StructTag 使用示例：

  1. import (
  2.     "log"
  3.     "strings"
  5.     "github.com/beego/beego/v2/core/validation"
  6. )
  8. // 验证函数写在 "valid" tag 的标签里
  9. // 各个函数之间用分号 ";" 分隔，分号后面可以有空格
  10. // 参数用括号 "()" 括起来，多个参数之间用逗号 "," 分开，逗号后面可以有空格
  11. // 正则函数(Match)的匹配模式用两斜杠 "/" 括起来
  12. // 各个函数的结果的 key 值为字段名.验证函数名
  13. type user struct {
  14.     Id     int
  15.     Name   string `valid:"Required;Match(/^Bee.*/)"` // Name 不能为空并且以 Bee 开头
  16.     Age    int    `valid:"Range(1, 140)"` // 1 <= Age <= 140，超出此范围即为不合法
  17.     Email  string `valid:"Email; MaxSize(100)"` // Email 字段需要符合邮箱格式，并且最大长度不能大于 100 个字符
  18.     Mobile string `valid:"Mobile"` // Mobile 必须为正确的手机号
  19.     IP     string `valid:"IP"` // IP 必须为一个正确的 IPv4 地址
  20. }
  22. // 如果你的 struct 实现了接口 validation.ValidFormer
  23. // 当 StructTag 中的测试都成功时，将会执行 Valid 函数进行自定义验证
  24. func (u *user) Valid(v *validation.Validation) {
  25.     if strings.Index(u.Name, "admin") != -1 {
  26.         // 通过 SetError 设置 Name 的错误信息，HasErrors 将会返回 true
  27.         v.SetError("Name", "名称里不能含有 admin")
  28.     }
  29. }
  31. func main() {
  32.     valid := validation.Validation{}
  33.     u := user{Name: "Beego", Age: 2, Email: "dev@web.me"}
  34.     b, err := valid.Valid(&u)
  35.     if err != nil {
  36.         // handle error
  37.     }
  38.     if !b {
  39.         // validation does not pass
  40.         // blabla...
  41.         for _, err := range valid.Errors {
  42.             log.Println(err.Key, err.Message)
  43.         }
  44.     }
  45. }

StructTag 可用的验证函数：

  • Required 不为空，即各个类型要求不为其零值
  • Min(min int) 最小值，有效类型：int，其他类型都将不能通过验证
  • Max(max int) 最大值，有效类型：int，其他类型都将不能通过验证
  • Range(min, max int) 数值的范围，有效类型：int，他类型都将不能通过验证
  • MinSize(min int) 最小长度，有效类型：string slice，其他类型都将不能通过验证
  • MaxSize(max int) 最大长度，有效类型：string slice，其他类型都将不能通过验证
  • Length(length int) 指定长度，有效类型：string slice，其他类型都将不能通过验证
  • Alpha alpha字符，有效类型：string，其他类型都将不能通过验证
  • Numeric 数字，有效类型：string，其他类型都将不能通过验证
  • AlphaNumeric alpha 字符或数字，有效类型：string，其他类型都将不能通过验证
  • Match(pattern string) 正则匹配，有效类型：string，其他类型都将被转成字符串再匹配(fmt.Sprintf(“%v”, obj).Match)
  • AlphaDash alpha 字符或数字或横杠 -_，有效类型：string，其他类型都将不能通过验证
  • Email 邮箱格式，有效类型：string，其他类型都将不能通过验证
  • IP IP 格式，目前只支持 IPv4 格式验证，有效类型：string，其他类型都将不能通过验证
  • Base64 base64 编码，有效类型：string，其他类型都将不能通过验证
  • Mobile 手机号，有效类型：string，其他类型都将不能通过验证
  • Tel 固定电话号，有效类型：string，其他类型都将不能通过验证
  • Phone 手机号或固定电话号，有效类型：string，其他类型都将不能通过验证
  • ZipCode 邮政编码，有效类型：string，其他类型都将不能通过验证

自定义验证

我们允许自己注册验证逻辑。使用方法：

  1. AddCustomFunc(name string, f CustomFunc) error

注意的是，该方法并不是线程安全的。在我们的设计理念中，注册这种自定义的方法，应该在系统初始化阶段完成。在该阶段，应当不存在竞争问题。

API 文档

请移步 Go Walker。