• 校验规则
    • required
    • required-if
    • required-unless
    • required-with
    • required-with-all
    • required-without
    • required-without-all
    • date
    • date-format
    • email
    • phone
    • telephone
    • passport
    • password
    • password2
    • password3
    • postcode
    • id-number
    • qq
    • ip
    • ipv4
    • ipv6
    • mac
    • url
    • domain
    • length
    • min-length
    • max-length
    • between
    • min
    • max
    • json
    • integer
    • float
    • boolean
    • same
    • different
    • in
    • not-in
    • regex

    gvalid模块实现了非常强大的数据校验功能，封装了40种常用的校验规则，支持单数据多规则校验、多数据多规则批量校验、自定义错误信息、自定义正则校验、支持struct tag规则及提示信息绑定等特性，是目前功能最强大的Go数据校验模块。

    使用方式：

    1. import "github.com/gogf/gf/g/util/gvalid"

    接口文档：

    https://godoc.org/github.com/gogf/gf/g/util/gvalid

    校验规则

    40种常用的校验规则：

    1. required             格式：required                              说明：必需参数
    2. required-if          格式：required-if:field,value,...           说明：必需参数(当任意所给定字段值与所给值相等时，即：当field字段的值为value时，当前验证字段为必须参数)
    3. required-unless      格式：required-unless:field,value,...       说明：必需参数(当所给定字段值与所给值都不相等时，即：当field字段的值不为value时，当前验证字段为必须参数)
    4. required-with        格式：required-with:field1,field2,...       说明：必需参数(当所给定任意字段值不为空时)
    5. required-with-all    格式：required-with-all:field1,field2,...   说明：必须参数(当所给定所有字段值都不为空时)
    6. required-without     格式：required-without:field1,field2,...    说明：必需参数(当所给定任意字段值为空时)
    7. required-without-all 格式：required-without-all:field1,field2,...说明：必须参数(当所给定所有字段值都为空时)
    8. date                 格式：date                                  说明：参数为常用日期类型，格式：2006-01-02, 20060102, 2006.01.02
    9. date-format          格式：date-format:format                    说明：判断日期是否为指定的日期格式，format为Go日期格式(可以包含时间)
    10. email                格式：email                                 说明：EMAIL邮箱地址
    11. phone                格式：phone                                 说明：手机号
    12. telephone            格式：telephone                             说明：国内座机电话号码，"XXXX-XXXXXXX"、"XXXX-XXXXXXXX"、"XXX-XXXXXXX"、"XXX-XXXXXXXX"、"XXXXXXX"、"XXXXXXXX"
    13. passport             格式：passport                              说明：通用帐号规则(字母开头，只能包含字母、数字和下划线，长度在6~18之间)
    14. password             格式：password                              说明：通用密码(任意可见字符，长度在6~18之间)
    15. password2            格式：password2                             说明：中等强度密码(在弱密码的基础上，必须包含大小写字母和数字)
    16. password3            格式：password3                             说明：强等强度密码(在弱密码的基础上，必须包含大小写字母、数字和特殊字符)
    17. postcode             格式：postcode                              说明：中国邮政编码
    18. id-number            格式：id-number                             说明：公民身份证号码
    19. qq                   格式：qq                                    说明：腾讯QQ号码
    20. ip                   格式：ip                                    说明：IPv4/IPv6地址
    21. ipv4                 格式：ipv4                                  说明：IPv4地址
    22. ipv6                 格式：ipv6                                  说明：IPv6地址
    23. mac                  格式：mac                                   说明：MAC地址
    24. url                  格式：url                                   说明：URL
    25. domain               格式：domain                                说明：域名
    26. length               格式：length:min,max                        说明：参数长度为min到max(长度参数为整形)，注意中文一个汉字占3字节
    27. min-length           格式：min-length:min                        说明：参数长度最小为min(长度参数为整形)，注意中文一个汉字占3字节
    28. max-length           格式：max-length:max                        说明：参数长度最大为max(长度参数为整形)，注意中文一个汉字占3字节
    29. between              格式：between:min,max                       说明：参数大小为min到max(支持整形和浮点类型参数)
    30. min                  格式：min:min                               说明：参数最小为min(支持整形和浮点类型参数)
    31. max                  格式：max:max                               说明：参数最大为max(支持整形和浮点类型参数)
    32. json                 格式：json                                  说明：判断数据格式为JSON
    33. integer              格式：integer                               说明：整数
    34. float                格式：float                                 说明：浮点数
    35. boolean              格式：boolean                               说明：布尔值(1,true,on,yes:true | 0,false,off,no,"":false)
    36. same                 格式：same:field                            说明：参数值必需与field参数的值相同
    37. different            格式：different:field                       说明：参数值不能与field参数的值相同
    38. in                   格式：in:value1,value2,...                  说明：参数值应该在value1,value2,...中(字符串匹配)
    39. not-in               格式：not-in:value1,value2,...              说明：参数值不应该在value1,value2,...中(字符串匹配)
    40. regex                格式：regex:pattern                         说明：参数值应当满足正则匹配规则pattern

    required

    • 格式: required
    • 说明：必需参数

    required-if

    • 格式: required-if:field,value,...
    • 说明：必需参数(当任意所给定字段值与所给值相等时，即：当field字段的值为value时，当前验证字段为必须参数)

    required-unless

    • 格式: required-unless:field,value,...
    • 说明：必需参数(当所给定字段值与所给值都不相等时，即：当field字段的值不为value时，当前验证字段为必须参数)

    required-with

    • 格式: required-with:field1,field2,...
    • 说明：必需参数(当所给定任意字段值不为空时)

    required-with-all

    • 格式: required-with-all:field1,field2,...
    • 说明：必须参数(当所给定所有字段值都不为空时)

    required-without

    • 格式: required-without:field1,field2,...
    • 说明：必需参数(当所给定任意字段值为空时)

    required-without-all

    • 格式: required-without-all:field1,field2,...
    • 说明：必须参数(当所给定所有字段值都为空时)

    date

    • 格式: date
    • 说明：参数为常用日期类型，日期之间支持的连接符号-或/或.，也支持不带连接符号的8位长度日期，格式如：2006-01-02, 2006/01/02, 2006.01.02, 20060102,01-Nov-2018, 01.Nov.018, 01/Nov/2018

    date-format

    • 格式: date-format:format
    • 说明：判断日期是否为指定的日期格式，format参数格式为gtime日期格式(可以包含日期及时间)，格式说明参考【gtime模块】章节。

    email

    • 格式: email
    • 说明：EMAIL邮箱地址

    phone

    • 格式: phone
    • 说明：手机号

    telephone

    • 格式: telephone
    • 说明：国内座机电话号码，”XXXX-XXXXXXX”、”XXXX-XXXXXXXX”、”XXX-XXXXXXX”、”XXX-XXXXXXXX”、”XXXXXXX”、”XXXXXXXX”

    passport

    • 格式: passport
    • 说明：通用帐号规则(字母开头，只能包含字母、数字和下划线，长度在6~18之间)

    password

    • 格式: password
    • 说明：通用密码(任意可见字符，长度在6~18之间)

    password2

    • 格式: password2
    • 说明：中等强度密码(在弱密码的基础上，必须包含大小写字母和数字)

    password3

    • 格式: password3
    • 说明：强等强度密码(在弱密码的基础上，必须包含大小写字母、数字和特殊字符)

    postcode

    • 格式: postcode
    • 说明：中国邮政编码

    id-number

    • 格式: id-number
    • 说明：公民身份证号码

    qq

    • 格式: qq
    • 说明：腾讯QQ号码

    ip

    • 格式: ip
    • 说明：IPv4/IPv6地址

    ipv4

    • 格式: ipv4
    • 说明：IPv4地址

    ipv6

    • 格式: ipv6
    • 说明：IPv6地址

    mac

    • 格式: mac
    • 说明：MAC地址

    url

    • 格式: url
    • 说明：URL

    domain

    • 格式: domain
    • 说明：域名

    length

    • 格式: length:min,max
    • 说明：参数长度为min到max(长度参数为整形)，注意中文一个汉字占3字节

    min-length

    • 格式: min-length:min
    • 说明：参数长度最小为min(长度参数为整形)，注意中文一个汉字占3字节

    max-length

    • 格式: max-length:max
    • 说明：参数长度最大为max(长度参数为整形)，注意中文一个汉字占3字节

    between

    • 格式: between:min,max
    • 说明：参数大小为min到max(支持整形和浮点类型参数)

    min

    • 格式: min:min
    • 说明：参数大小最小为min(支持整形和浮点类型参数)

    max

    • 格式: max:max
    • 说明：参数大小最大为max(支持整形和浮点类型参数)

    json

    • 格式: json
    • 说明：判断数据格式为JSON

    integer

    • 格式: integer
    • 说明：整数

    float

    • 格式: float
    • 说明：浮点数

    boolean

    • 格式: boolean
    • 说明：布尔值(1,true,on,yes为true | 0,false,off,no,""为false)

    same

    • 格式: same:field
    • 说明：参数值必需与field参数的值相同

    different

    • 格式: different:field
    • 说明：参数值不能与field参数的值相同

    in

    • 格式: in:value1,value2,...
    • 说明：参数值应该在value1,value2,...中(字符串匹配)

    not-in

    • 格式: not-in:value1,value2,...
    • 说明：参数值不应该在value1,value2,...中(字符串匹配)

    regex

    • 格式: regex:pattern
    • 说明：参数值应当满足正则匹配规则pattern