GoFrame框架校验组件内置了数十项常用的校验规则,校验组件是开发者最频繁使用的框架核心组件之一。

校验规则涉及到联合校验的场景时,规则中关联的参数名称会自动按照不区分大小写且忽略特殊字符的形式进行智能匹配。

required

  • 格式: required
  • 说明:必需参数,除了支持常见的字符串,也支持Slice/Map类型。
  • 示例:姓名字段Name为必需参数必需不能为空。

    1. func Example_Rule_Required() {
    2. type BizReq struct {
    3. ID uint `v:"required"`
    4. Name string `v:"required"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. ID: 1,
    10. }
    11. )
    12. if err := g.Validator().Data(req).Run(ctx); err != nil {
    13. fmt.Print(err)
    14. }
    15. // Output:
    16. // The Name field is required
    17. }

required-if

  • 格式: required-if:field,value,...
  • 说明:必需参数(当任意所给定字段值与所给值相等时,即:当field字段的值为value时,当前验证字段为必须参数)。多个字段以,号分隔。
  • 示例:当Gender字段为1WifeName字段必须不为空, 当Gender字段为2HusbandName字段必须不为空。

    1. func Example_Rule_RequiredIf() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string `v:"required-if:gender,1"`
    7. HusbandName string `v:"required-if:gender,2"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. ID: 1,
    13. Name: "test",
    14. Gender: 1,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Println(err)
    19. }
    20. // Output:
    21. // The WifeName field is required
    22. }

required-unless

  • 格式: required-unless:field,value,...
  • 说明:必需参数(当所给定字段值与所给值都不相等时,即:当field字段的值不为value时,当前验证字段为必须参数)。多个字段以,号分隔。
  • 示例:当Gender不等于0Gender不等于2时,WifeName必须不为空;当Id不等于0Gender不等于2时,HusbandName必须不为空。

    1. func Example_Rule_RequiredUnless() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string `v:"required-unless:gender,0,gender,2"`
    7. HusbandName string `v:"required-unless:id,0,gender,2"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. ID: 1,
    13. Name: "test",
    14. Gender: 1,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Println(err)
    19. }
    20. // Output:
    21. // The WifeName field is required; The HusbandName field is required
    22. }

required-with

  • 格式: required-with:field1,field2,...
  • 说明:必需参数(当所给定任意字段值其中之一不为空时)。
  • 示例:当WifeName不为空时,HusbandName必须不为空。

    1. func Example_Rule_RequiredWith() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string
    7. HusbandName string `v:"required-with:WifeName"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. ID: 1,
    13. Name: "test",
    14. Gender: 1,
    15. WifeName: "Ann",
    16. }
    17. )
    18. if err := g.Validator().Data(req).Run(ctx); err != nil {
    19. fmt.Println(err)
    20. }
    21. // Output:
    22. // The HusbandName field is required
    23. }

required-with-all

  • 格式: required-with-all:field1,field2,...
  • 说明:必须参数(当所给定所有字段值全部都不为空时)。
  • 示例:当Id,Name,Gender,WifeName全部不为空时,HusbandName必须不为空。

    1. func Example_Rule_RequiredWithAll() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string
    7. HusbandName string `v:"required-with-all:Id,Name,Gender,WifeName"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. ID: 1,
    13. Name: "test",
    14. Gender: 1,
    15. WifeName: "Ann",
    16. }
    17. )
    18. if err := g.Validator().Data(req).Run(ctx); err != nil {
    19. fmt.Println(err)
    20. }
    21. // Output:
    22. // The HusbandName field is required
    23. }

required-without

  • 格式: required-without:field1,field2,...
  • 说明:必需参数(当所给定任意字段值其中之一为空时)。
  • 示例:当IdWifeName为空时,HusbandName必须不为空。

    1. func Example_Rule_RequiredWithout() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string
    7. HusbandName string `v:"required-without:Id,WifeName"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. ID: 1,
    13. Name: "test",
    14. Gender: 1,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Println(err)
    19. }
    20. // Output:
    21. // The HusbandName field is required
    22. }

required-without-all

  • 格式: required-without-all:field1,field2,...
  • 说明:必须参数(当所给定所有字段值全部都为空时)。
  • 示例:当IdWifeName都为空时,HusbandName必须不为空。

    1. func Example_Rule_RequiredWithoutAll() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your ID"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. WifeName string
    7. HusbandName string `v:"required-without-all:Id,WifeName"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. Name: "test",
    13. Gender: 1,
    14. }
    15. )
    16. if err := g.Validator().Data(req).Run(ctx); err != nil {
    17. fmt.Println(err)
    18. }
    19. // Output:
    20. // The HusbandName field is required
    21. }

bail

  • 格式:bail
  • 说明:只要后续的多个校验中有一个规则校验失败则停止校验并立即返回校验结果。
  • 示例:

    1. func Example_Rule_Bail() {
    2. type BizReq struct {
    3. Account string `v:"bail|required|length:6,16|same:QQ"`
    4. QQ string
    5. Password string `v:"required|same:Password2"`
    6. Password2 string `v:"required"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Account: "gf",
    12. QQ: "123456",
    13. Password: "goframe.org",
    14. Password2: "goframe.org",
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Println(err)
    19. }
    20. // output:
    21. // The Account value `gf` length must be between 6 and 16
    22. }

ci

  • 格式: ci
  • 说明:字段值比较在默认情况下为区分大小写严格匹配比较,通过Case Insensitive,可以设置对于需要比较值的规则字段为不区分大小写。如:same, different, in, not-in等。
  • 示例:

    1. func Example_Rule_CaseInsensitive() {
    2. type BizReq struct {
    3. Account string `v:"required"`
    4. Password string `v:"required|ci|same:Password2"`
    5. Password2 string `v:"required"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Account: "gf",
    11. Password: "Goframe.org", // Diff from Password2, but because of "ci", rule check passed
    12. Password2: "goframe.org",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Println(err)
    17. }
    18. // output:
    19. }

date

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

    1. func Example_Rule_Date() {
    2. type BizReq struct {
    3. Date1 string `v:"date"`
    4. Date2 string `v:"date"`
    5. Date3 string `v:"date"`
    6. Date4 string `v:"date"`
    7. Date5 string `v:"date"`
    8. }
    9. var (
    10. ctx = context.Background()
    11. req = BizReq{
    12. Date1: "2021-10-31",
    13. Date2: "2021.10.31",
    14. Date3: "2021-Oct-31",
    15. Date4: "2021 Octa 31",
    16. Date5: "2021/Oct/31",
    17. }
    18. )
    19. if err := g.Validator().Data(req).Run(ctx); err != nil {
    20. fmt.Print(gstr.Join(err.Strings(), "\n"))
    21. }
    22. // Output:
    23. // The Date3 value `2021-Oct-31` is not a valid date
    24. // The Date4 value `2021 Octa 31` is not a valid date
    25. // The Date5 value `2021/Oct/31` is not a valid date
    26. }

datetime

  • 格式: datetime
  • 说明:参数为常用日期时间类型,其中日期之间支持的连接符号只支持-,格式如: 2006-01-02 12:00:00
  • 示例:

    1. func Example_Rule_Datetime() {
    2. type BizReq struct {
    3. Date1 string `v:"datetime"`
    4. Date2 string `v:"datetime"`
    5. Date3 string `v:"datetime"`
    6. Date4 string `v:"datetime"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Date1: "2021-11-01 23:00:00",
    12. Date2: "2021-11-01 23:00", // error
    13. Date3: "2021/11/01 23:00:00", // error
    14. Date4: "2021/Dec/01 23:00:00", // error
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Date2 value `2021-11-01 23:00` is not a valid datetime
    22. // The Date3 value `2021/11/01 23:00:00` is not a valid datetime
    23. // The Date4 value `2021/Dec/01 23:00:00` is not a valid datetime
    24. }

date-format

  • 格式: date-format:format
  • 说明:判断日期是否为指定的日期/时间格式,format参数格式为gtime日期格式(可以包含日期及时间),格式说明参考章节:gtime模块
  • 示例:date-format:Y-m-d H:i:s

    1. func Example_Rule_DateFormat() {
    2. type BizReq struct {
    3. Date1 string `v:"date-format:Y-m-d"`
    4. Date2 string `v:"date-format:Y-m-d"`
    5. Date3 string `v:"date-format:Y-m-d H:i:s"`
    6. Date4 string `v:"date-format:Y-m-d H:i:s"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Date1: "2021-11-01",
    12. Date2: "2021-11-01 23:00", // error
    13. Date3: "2021-11-01 23:00:00",
    14. Date4: "2021-11-01 23:00", // error
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Date2 value `2021-11-01 23:00` does not match the format: Y-m-d
    22. // The Date4 value `2021-11-01 23:00` does not match the format: Y-m-d H:i:s
    23. }

email

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

    1. func Example_Rule_Email() {
    2. type BizReq struct {
    3. MailAddr1 string `v:"email"`
    4. MailAddr2 string `v:"email"`
    5. MailAddr3 string `v:"email"`
    6. MailAddr4 string `v:"email"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. MailAddr1: "gf@goframe.org",
    12. MailAddr2: "gf@goframe", // error
    13. MailAddr3: "gf@goframe.org.cn",
    14. MailAddr4: "gf#goframe.org", // error
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The MailAddr2 value `gf@goframe` is not a valid email address
    22. // The MailAddr4 value `gf#goframe.org` is not a valid email address
    23. }

phone

  • 格式:phone
  • 说明:大中国区手机号格式。

    1. func Example_Rule_Phone() {
    2. type BizReq struct {
    3. PhoneNumber1 string `v:"phone"`
    4. PhoneNumber2 string `v:"phone"`
    5. PhoneNumber3 string `v:"phone"`
    6. PhoneNumber4 string `v:"phone"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. PhoneNumber1: "13578912345",
    12. PhoneNumber2: "11578912345", // error 11x not exist
    13. PhoneNumber3: "17178912345", // error 171 not exit
    14. PhoneNumber4: "1357891234", // error len must be 11
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The PhoneNumber2 value `11578912345` is not a valid phone number
    22. // The PhoneNumber3 value `17178912345` is not a valid phone number
    23. // The PhoneNumber4 value `1357891234` is not a valid phone number
    24. }

phone-loose

  • 格式: phone
  • 说明:宽松的手机号验证,只要满足 13、14、15、16、17、18、19开头的11位数字都可以通过验证。可用于非严格的业务场景。

    1. func Example_Rule_PhoneLoose() {
    2. type BizReq struct {
    3. PhoneNumber1 string `v:"phone-loose"`
    4. PhoneNumber2 string `v:"phone-loose"`
    5. PhoneNumber3 string `v:"phone-loose"`
    6. PhoneNumber4 string `v:"phone-loose"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. PhoneNumber1: "13578912345",
    12. PhoneNumber2: "11578912345", // error 11x not exist
    13. PhoneNumber3: "17178912345",
    14. PhoneNumber4: "1357891234", // error len must be 11
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The PhoneNumber2 value `11578912345` is invalid
    22. // The PhoneNumber4 value `1357891234` is invalid
    23. }

telephone

  • 格式: telephone
  • 说明:大中国区座机电话号码,”XXXX-XXXXXXX”、”XXXX-XXXXXXXX”、”XXX-XXXXXXX”、”XXX-XXXXXXXX”、”XXXXXXX”、”XXXXXXXX”。

    1. func Example_Rule_Telephone() {
    2. type BizReq struct {
    3. Telephone1 string `v:"telephone"`
    4. Telephone2 string `v:"telephone"`
    5. Telephone3 string `v:"telephone"`
    6. Telephone4 string `v:"telephone"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Telephone1: "010-77542145",
    12. Telephone2: "0571-77542145",
    13. Telephone3: "20-77542145", // error
    14. Telephone4: "775421451", // error len must be 7 or 8
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Telephone3 value `20-77542145` is not a valid telephone number
    22. // The Telephone4 value `775421451` is not a valid telephone number
    23. }

passport

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

    1. func Example_Rule_Passport() {
    2. type BizReq struct {
    3. Passport1 string `v:"passport"`
    4. Passport2 string `v:"passport"`
    5. Passport3 string `v:"passport"`
    6. Passport4 string `v:"passport"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Passport1: "goframe",
    12. Passport2: "1356666", // error starting with letter
    13. Passport3: "goframe#", // error containing only numbers or underscores
    14. Passport4: "gf", // error length between 6 and 18
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Passport2 value `1356666` is not a valid passport format
    22. // The Passport3 value `goframe#` is not a valid passport format
    23. // The Passport4 value `gf` is not a valid passport format
    24. }

password

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

    1. func Example_Rule_Password() {
    2. type BizReq struct {
    3. Password1 string `v:"password"`
    4. Password2 string `v:"password"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. Password1: "goframe",
    10. Password2: "gofra", // error length between 6 and 18
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The Password2 value `gofra` is not a valid password format
    18. }

password2

  • 格式: password2
  • 说明:中等强度密码(在通用密码规则的基础上,要求密码必须包含大小写字母和数字)。

    1. func Example_Rule_Password2() {
    2. type BizReq struct {
    3. Password1 string `v:"password2"`
    4. Password2 string `v:"password2"`
    5. Password3 string `v:"password2"`
    6. Password4 string `v:"password2"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Password1: "Goframe123",
    12. Password2: "gofra", // error length between 6 and 18
    13. Password3: "Goframe", // error must contain lower and upper letters and numbers.
    14. Password4: "goframe123", // error must contain lower and upper letters and numbers.
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Password2 value `gofra` is not a valid password format
    22. // The Password3 value `Goframe` is not a valid password format
    23. // The Password4 value `goframe123` is not a valid password format
    24. }

password3

  • 格式: password3
  • 说明:强等强度密码(在通用密码规则的基础上,必须包含大小写字母、数字和特殊字符)。

    1. func Example_Rule_Password3() {
    2. type BizReq struct {
    3. Password1 string `v:"password3"`
    4. Password2 string `v:"password3"`
    5. Password3 string `v:"password3"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Password1: "Goframe123#",
    11. Password2: "gofra", // error length between 6 and 18
    12. Password3: "Goframe123", // error must contain lower and upper letters, numbers and special chars.
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(gstr.Join(err.Strings(), "\n"))
    17. }
    18. // Output:
    19. // The Password2 value `gofra` is not a valid password format
    20. // The Password3 value `Goframe123` is not a valid password format
    21. }

postcode

  • 格式: postcode
  • 说明:大中国区邮政编码规则。

    1. func Example_Rule_Postcode() {
    2. type BizReq struct {
    3. Postcode1 string `v:"postcode"`
    4. Postcode2 string `v:"postcode"`
    5. Postcode3 string `v:"postcode"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Postcode1: "100000",
    11. Postcode2: "10000", // error length must be 6
    12. Postcode3: "1000000", // error length must be 6
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(gstr.Join(err.Strings(), "\n"))
    17. }
    18. // Output:
    19. // The Postcode2 value `10000` is not a valid postcode format
    20. // The Postcode3 value `1000000` is not a valid postcode format
    21. }

resident-id

  • 格式: resident-id
  • 说明:公民身份证号码。

    1. func Example_Rule_ResidentId() {
    2. type BizReq struct {
    3. ResidentID1 string `v:"resident-id"`
    4. }
    5. var (
    6. ctx = context.Background()
    7. req = BizReq{
    8. ResidentID1: "320107199506285482",
    9. }
    10. )
    11. if err := g.Validator().Data(req).Run(ctx); err != nil {
    12. fmt.Print(err)
    13. }
    14. // Output:
    15. // The ResidentID1 value `320107199506285482` is not a valid resident id number
    16. }

bank-card

  • 格式: bank-card
  • 说明:大中国区银行卡号校验。

    1. func Example_Rule_BankCard() {
    2. type BizReq struct {
    3. BankCard1 string `v:"bank-card"`
    4. }
    5. var (
    6. ctx = context.Background()
    7. req = BizReq{
    8. BankCard1: "6225760079930218",
    9. }
    10. )
    11. if err := g.Validator().Data(req).Run(ctx); err != nil {
    12. fmt.Print(err)
    13. }
    14. // Output:
    15. // The BankCard1 value `6225760079930218` is not a valid bank card number
    16. }

qq

  • 格式: qq
  • 说明:腾讯QQ号码规则。

    1. func Example_Rule_QQ() {
    2. type BizReq struct {
    3. QQ1 string `v:"qq"`
    4. QQ2 string `v:"qq"`
    5. QQ3 string `v:"qq"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. QQ1: "389961817",
    11. QQ2: "9999", // error >= 10000
    12. QQ3: "514258412a", // error all number
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(gstr.Join(err.Strings(), "\n"))
    17. }
    18. // Output:
    19. // The QQ2 value `9999` is not a valid QQ number
    20. // The QQ3 value `514258412a` is not a valid QQ number
    21. }

ip

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

    1. func Example_Rule_IP() {
    2. type BizReq struct {
    3. IP1 string `v:"ip"`
    4. IP2 string `v:"ip"`
    5. IP3 string `v:"ip"`
    6. IP4 string `v:"ip"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. IP1: "127.0.0.1",
    12. IP2: "fe80::812b:1158:1f43:f0d1",
    13. IP3: "520.255.255.255", // error >= 10000
    14. IP4: "ze80::812b:1158:1f43:f0d1",
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The IP3 value `520.255.255.255` is not a valid IP address
    22. // The IP4 value `ze80::812b:1158:1f43:f0d1` is not a valid IP address
    23. }

ipv4

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

    1. func Example_Rule_IPV4() {
    2. type BizReq struct {
    3. IP1 string `v:"ipv4"`
    4. IP2 string `v:"ipv4"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. IP1: "127.0.0.1",
    10. IP2: "520.255.255.255",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The IP2 value `520.255.255.255` is not a valid IPv4 address
    18. }

ipv6

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

    1. func Example_Rule_IPV6() {
    2. type BizReq struct {
    3. IP1 string `v:"ipv6"`
    4. IP2 string `v:"ipv6"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. IP1: "fe80::812b:1158:1f43:f0d1",
    10. IP2: "ze80::812b:1158:1f43:f0d1",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The IP2 value `ze80::812b:1158:1f43:f0d1` is not a valid IPv6 address
    18. }

mac

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

    1. func Example_Rule_Mac() {
    2. type BizReq struct {
    3. Mac1 string `v:"mac"`
    4. Mac2 string `v:"mac"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. Mac1: "4C-CC-6A-D6-B1-1A",
    10. Mac2: "Z0-CC-6A-D6-B1-1A",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The Mac2 value `Z0-CC-6A-D6-B1-1A` is not a valid MAC address
    18. }

url

  • 格式: url
  • 说明:URL
  • 示例:支持以http,https,ftp,file开头的地址。

    1. func Example_Rule_Url() {
    2. type BizReq struct {
    3. URL1 string `v:"url"`
    4. URL2 string `v:"url"`
    5. URL3 string `v:"url"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. URL1: "http://goframe.org",
    11. URL2: "ftp://goframe.org",
    12. URL3: "ws://goframe.org",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(err)
    17. }
    18. // Output:
    19. // The URL3 value `ws://goframe.org` is not a valid URL address
    20. }

domain

  • 格式: domain
  • 说明:域名
  • 示例:域名规则。xxx.yyy(首位必须为字母)。

    1. func Example_Rule_Domain() {
    2. type BizReq struct {
    3. Domain1 string `v:"domain"`
    4. Domain2 string `v:"domain"`
    5. Domain3 string `v:"domain"`
    6. Domain4 string `v:"domain"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Domain1: "goframe.org",
    12. Domain2: "a.b",
    13. Domain3: "goframe#org",
    14. Domain4: "1a.2b",
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Domain3 value `goframe#org` is not a valid domain format
    22. // The Domain4 value `1a.2b` is not a valid domain format
    23. }

size

  • 格式: size:size
  • 说明:参数长度size (长度参数为整形),注意底层使用Unicode计算长度,因此中文一个汉字占1个长度单位。

    1. func Example_Rule_Size() {
    2. type BizReq struct {
    3. Size1 string `v:"size:10"`
    4. Size2 string `v:"size:5"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. Size1: "goframe欢迎你",
    10. Size2: "goframe",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The Size2 value `goframe` length must be 5
    18. }

length

  • 格式: length:min,max
  • 说明:参数长度minmax(长度参数为整形),注意底层使用Unicode计算长度,因此中文一个汉字占1个长度单位。

    1. func Example_Rule_Length() {
    2. type BizReq struct {
    3. Length1 string `v:"length:5,10"`
    4. Length2 string `v:"length:10,15"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. Length1: "goframe欢迎你",
    10. Length2: "goframe",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The Length2 value `goframe` length must be between 10 and 15
    18. }

min-length

  • 格式: min-length:min
  • 说明:参数长度最小为min(长度参数为整形),注意底层使用Unicode计算长度,因此中文一个汉字占1个长度单位。

    1. func Example_Rule_MinLength() {
    2. type BizReq struct {
    3. MinLength1 string `v:"min-length:10"`
    4. MinLength2 string `v:"min-length:8"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. MinLength1: "goframe欢迎你",
    10. MinLength2: "goframe",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The MinLength2 value `goframe` length must be equal or greater than 8
    18. }

max-length

  • 格式: max-length:max
  • 说明:参数长度最大为max(长度参数为整形),注意底层使用Unicode计算长度,因此中文一个汉字占1个长度单位。

    1. func Example_Rule_MaxLength() {
    2. type BizReq struct {
    3. MaxLength1 string `v:"max-length:10"`
    4. MaxLength2 string `v:"max-length:5"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. MaxLength1: "goframe欢迎你",
    10. MaxLength2: "goframe",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The MaxLength2 value `goframe` length must be equal or lesser than 5
    18. }

between

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

    1. func Example_Rule_Between() {
    2. type BizReq struct {
    3. Age1 int `v:"between:1,100"`
    4. Age2 int `v:"between:1,100"`
    5. Score1 float32 `v:"between:0.0,10.0"`
    6. Score2 float32 `v:"between:0.0,10.0"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Age1: 50,
    12. Age2: 101,
    13. Score1: 9.8,
    14. Score2: -0.5,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Age2 value `101` must be between 1 and 100
    22. // The Score2 value `-0.5` must be between 0 and 10
    23. }

min

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

    1. func Example_Rule_Min() {
    2. type BizReq struct {
    3. Age1 int `v:"min:100"`
    4. Age2 int `v:"min:100"`
    5. Score1 float32 `v:"min:10.0"`
    6. Score2 float32 `v:"min:10.0"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Age1: 50,
    12. Age2: 101,
    13. Score1: 9.8,
    14. Score2: 10.1,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Age1 value `50` must be equal or greater than 100
    22. // The Score1 value `9.8` must be equal or greater than 10
    23. }

max

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

    1. func Example_Rule_Max() {
    2. type BizReq struct {
    3. Age1 int `v:"max:100"`
    4. Age2 int `v:"max:100"`
    5. Score1 float32 `v:"max:10.0"`
    6. Score2 float32 `v:"max:10.0"`
    7. }
    8. var (
    9. ctx = context.Background()
    10. req = BizReq{
    11. Age1: 99,
    12. Age2: 101,
    13. Score1: 9.9,
    14. Score2: 10.1,
    15. }
    16. )
    17. if err := g.Validator().Data(req).Run(ctx); err != nil {
    18. fmt.Print(gstr.Join(err.Strings(), "\n"))
    19. }
    20. // Output:
    21. // The Age2 value `101` must be equal or lesser than 100
    22. // The Score2 value `10.1` must be equal or lesser than 10
    23. }

json

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

    1. func Example_Rule_Json() {
    2. type BizReq struct {
    3. JSON1 string `v:"json"`
    4. JSON2 string `v:"json"`
    5. }
    6. var (
    7. ctx = context.Background()
    8. req = BizReq{
    9. JSON1: "{\"name\":\"goframe\",\"author\":\"郭强\"}",
    10. JSON2: "{\"name\":\"goframe\",\"author\":\"郭强\",\"test\"}",
    11. }
    12. )
    13. if err := g.Validator().Data(req).Run(ctx); err != nil {
    14. fmt.Print(err)
    15. }
    16. // Output:
    17. // The JSON2 value `{"name":"goframe","author":"郭强","test"}` is not a valid JSON string
    18. }

integer

  • 格式: integer
  • 说明:整数(正整数或者负整数)。

    1. func Example_Rule_Integer() {
    2. type BizReq struct {
    3. Integer string `v:"integer"`
    4. Float string `v:"integer"`
    5. Str string `v:"integer"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Integer: "100",
    11. Float: "10.0",
    12. Str: "goframe",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(gstr.Join(err.Strings(), "\n"))
    17. }
    18. // Output:
    19. // The Float value `10.0` is not an integer
    20. // The Str value `goframe` is not an integer
    21. }

float

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

    1. func Example_Rule_Float() {
    2. type BizReq struct {
    3. Integer string `v:"float"`
    4. Float string `v:"float"`
    5. Str string `v:"float"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Integer: "100",
    11. Float: "10.0",
    12. Str: "goframe",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(err)
    17. }
    18. // Output:
    19. // The Str value `goframe` is invalid
    20. }

boolean

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

    1. func Example_Rule_Boolean() {
    2. type BizReq struct {
    3. Boolean bool `v:"boolean"`
    4. Integer int `v:"boolean"`
    5. Float float32 `v:"boolean"`
    6. Str1 string `v:"boolean"`
    7. Str2 string `v:"boolean"`
    8. Str3 string `v:"boolean"`
    9. }
    10. var (
    11. ctx = context.Background()
    12. req = BizReq{
    13. Boolean: true,
    14. Integer: 1,
    15. Float: 10.0,
    16. Str1: "on",
    17. Str2: "",
    18. Str3: "goframe",
    19. }
    20. )
    21. if err := g.Validator().Data(req).Run(ctx); err != nil {
    22. fmt.Print(gstr.Join(err.Strings(), "\n"))
    23. }
    24. // Output:
    25. // The Float value `10` field must be true or false
    26. // The Str3 value `goframe` field must be true or false
    27. }

same

  • 格式: same:field
  • 说明:参数值必需与field字段参数的值相同。
  • 示例:在用户注册时,提交密码Password和确认密码Password2必须相等(服务端校验)。

    1. func Example_Rule_Same() {
    2. type BizReq struct {
    3. Name string `v:"required"`
    4. Password string `v:"required|same:Password2"`
    5. Password2 string `v:"required"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Name: "gf",
    11. Password: "goframe.org",
    12. Password2: "goframe.net",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Println(err)
    17. }
    18. // Output:
    19. // The Password value `goframe.org` must be the same as field Password2
    20. }

different

  • 格式: different:field
  • 说明:参数值不能与field字段参数的值相同。
  • 示例:备用邮箱OtherMailAddr和邮箱地址MailAddr必须不相同。

    1. func Example_Rule_Different() {
    2. type BizReq struct {
    3. Name string `v:"required"`
    4. MailAddr string `v:"required"`
    5. ConfirmMailAddr string `v:"required|different:MailAddr"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Name: "gf",
    11. MailAddr: "gf@goframe.org",
    12. ConfirmMailAddr: "gf@goframe.org",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Println(err)
    17. }
    18. // Output:
    19. // The ConfirmMailAddr value `gf@goframe.org` must be different from field MailAddr
    20. }

in

  • 格式: in:value1,value2,...
  • 说明:参数值应该在value1,value2,...中(字符串匹配)。
  • 示例:性别字段Gender的值必须在0/1/2中。

    1. func Example_Rule_In() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your Id"`
    4. Name string `v:"required" dc:"Your name"`
    5. Gender uint `v:"in:0,1,2" dc:"0:Secret;1:Male;2:Female"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. ID: 1,
    11. Name: "test",
    12. Gender: 3,
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Println(err)
    17. }
    18. // Output:
    19. // The Gender value `3` is not in acceptable range: 0,1,2
    20. }

not-in

  • 格式: not-in:value1,value2,...
  • 说明:参数值不应该在value1,value2,...中(字符串匹配)。
  • 示例:无效索引InvalidIndex的值必须不在-1/0/1中。

    1. func Example_Rule_NotIn() {
    2. type BizReq struct {
    3. ID uint `v:"required" dc:"Your Id"`
    4. Name string `v:"required" dc:"Your name"`
    5. InvalidIndex uint `v:"not-in:-1,0,1"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. ID: 1,
    11. Name: "test",
    12. InvalidIndex: 1,
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Println(err)
    17. }
    18. // Output:
    19. // The InvalidIndex value `1` must not be in range: -1,0,1
    20. }

regex

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

    1. func Example_Rule_Regex() {
    2. type BizReq struct {
    3. Regex1 string `v:"regex:[1-9][0-9]{4,14}"`
    4. Regex2 string `v:"regex:[1-9][0-9]{4,14}"`
    5. Regex3 string `v:"regex:[1-9][0-9]{4,14}"`
    6. }
    7. var (
    8. ctx = context.Background()
    9. req = BizReq{
    10. Regex1: "1234",
    11. Regex2: "01234",
    12. Regex3: "10000",
    13. }
    14. )
    15. if err := g.Validator().Data(req).Run(ctx); err != nil {
    16. fmt.Print(gstr.Join(err.Strings(), "\n"))
    17. }
    18. // Output:
    19. // The Regex1 value `1234` must be in regex of: [1-9][0-9]{4,14}
    20. // The Regex2 value `01234` must be in regex of: [1-9][0-9]{4,14}
    21. }