[TOC] # 表单验证 表单验证是用于数据验证和错误收集的模块。 ## 安装及测试 安装: go get github.com/astaxie/beego/validation 测试: go test github.com/astaxie/beego/validation ## 示例 直接使用示例: ```go import ( "github.com/astaxie/beego/validation" "log" ) type User struct { Name string Age int } func main() { u := User{"man", 40} valid := validation.Validation{} valid.Required(u.Name, "name") valid.MaxSize(u.Name, 15, "nameMax") valid.Range(u.Age, 0, 18, "age") if valid.HasErrors() { // 如果有错误信息,证明验证没通过 // 打印错误信息 for _, err := range valid.Errors { log.Println(err.Key, err.Message) } } // or use like this if v := valid.Max(u.Age, 140, "age"); !v.Ok { log.Println(v.Error.Key, v.Error.Message) } // 定制错误信息 minAge := 18 valid.Min(u.Age, minAge, "age").Message("少儿不宜!") // 错误信息格式化 valid.Min(u.Age, minAge, "age").Message("%d不禁", minAge) } ``` 通过 StructTag 使用示例: ```go import ( "log" "strings" "github.com/astaxie/beego/validation" ) // 验证函数写在 "valid" tag 的标签里 // 各个函数之间用分号 ";" 分隔,分号后面可以有空格 // 参数用括号 "()" 括起来,多个参数之间用逗号 "," 分开,逗号后面可以有空格 // 正则函数(Match)的匹配模式用两斜杠 "/" 括起来 // 各个函数的结果的key值为字段名.验证函数名 type user struct { Id int Name string `valid:"Required;Match(/^Bee.*/)"` // Name 不能为空并且以Bee开头 Age int `valid:"Range(1, 140)"` // 1 <= Age <= 140,超出此范围即为不合法 Email string `valid:"Email; MaxSize(100)"` // Email字段需要符合邮箱格式,并且最大长度不能大于100个字符 Mobile string `valid:"Mobile"` // Mobile必须为正确的手机号 IP string `valid:"IP"` // IP必须为一个正确的IPv4地址 } // 如果你的 struct 实现了接口 validation.ValidFormer // 当 StructTag 中的测试都成功时,将会执行 Valid 函数进行自定义验证 func (u *user) Valid(v *validation.Validation) { if strings.Index(u.Name, "admin") != -1 { // 通过 SetError 设置 Name 的错误信息,HasErrors 将会返回 true v.SetError("Name", "名称里不能含有 admin") } } func main() { valid := validation.Validation{} u := user{Name: "Beego", Age: 2, Email: "dev@beego.me"} b, err := valid.Valid(&u) if err != nil { // handle error } if !b { // validation does not pass // blabla... for _, err := range valid.Errors { log.Println(err.Key, err.Message) } } } ``` 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`,其他类型都将不能通过验证 ### API 文档 请移步 [Go Walker](http://gowalker.org/github.com/astaxie/beego/validation)。