直接使用

package main

import (
	"github.com/sohaha/zlsgo/zlog"
	"github.com/sohaha/zlsgo/zvalid"
)

func main() {

	// 需要验证的数据
	data := "我是需要验证的数据，我的作用是做用户名"
	// 开始验证数据，不能为空，必须包含字母
	name, err := zvalid.Text(data, "用户名").Required().HasNumber().HasLetter().String()
	if err != nil {
		zlog.Debug("验证失败", err)
	}

	data = "我是需要验证的数据，我的作用是做用户名，我有字母 A"
	name, err = zvalid.Text(data, "用户名").Required().HasLetter().String()
	zlog.Debug("用户名是:", name)

	// 初始化一个对象，并绑定需要验证的字符串
	// zvalid.New().Verifi("username","用户名").String()

	// ... 更多用法

}

HTTP 服务器内使用

r.GET("/demo", func(c *znet.Context) {

		// 批量验证
		var data struct {
			Site string `json:"site"`
			Url  string
		}

		// 创建一个共用不能为空规则做默认规则器，非必须
		rule := c.ValidRule().Required()
		err := zvalid.Batch(
			// 验证数据 c.Valid(规则器, "表单 key，支持 GET 与 POST 的数据 key", "字段名")
			zvalid.BatchVar(&data.Site, c.Valid(rule, "site", "站点")),
			zvalid.BatchVar(&data.Site, c.Valid(rule, "url", "URL").Customize(func(rawValue string, err error) (newValue string, newErr error) {
				// 这里自定义验证数据或修改数据
				// ...
				return
			})),
		)
		c.Log.Info(err, data)

		// 绑定并且验证数据
		rule := c.ValidRule().Required()
		err := c.BindValid(&data,map[string]zvalid.Engine{
			"site":rule.SetAlias("站点"),
		})

		// 或直接验证字段
		site, err := c.Valid(rule, "site", "站点").String()
		c.Log.Info(site, err)

		err = c.ValidForm(c.ValidRule().Required(), "url", "URL").Error()
		c.Log.Info(err)
	})

数据验证

检查数据是否指定类型

注意该函数不检查空值所以如果是必填请先添加 .Required("不能为空")

// 示例：用户名必须是英文字母
zvalid.Text(data, "用户名").Required("不能空值").IsLetter("这里可以自定义错误信息，如：必须是英文字母").String()

// 必须是布尔值
.IsBool()
// 必须是小写字母
.IsLower()
// 必须是大写字母
.IsUpper()
// 必须是字母
.IsLetter()
// 必须是整数
.IsNumber()
// 必须是小写字母或数字
.IsLowerOrDigit()
// 必须是大写字母或数字
.IsUpperOrDigit()
// 必须是字母或数字
.IsLetterOrDigit()
// 必须是中文
.IsChinese()
// 必须是手机号码
.IsMobile()
// 必须是电子邮箱
.IsMail()
// 必须是 URL
.IsURL()
// 必须是 IP
.IsIP()
// 必须是 JSON
.IsJSON()
// 必须是身份证号码
.IsChineseIDNumber()
// 长度不能小于指定长度
.MinLength(min int)
// 长度不能小于指定 UTF8 编码长度
.MinUTF8Length(min int)
// 长度不能大于指定长度
.MaxLength(max int)
// 长度不能大于指定 UTF8 编码长度
.MaxUTF8Length(max int)
// 最小数字
.MinInt(min int)
// 最大数字
.MaxInt(max int)
// 最小浮点数
.MinFloat(min float64)
// 最大浮点数
.MaxFloat(max float64)
// 只允许的指定字符串
.EnumString(slice []string)
// 只允许的指定数字
.EnumInt(i []int)
// 只允许的指定浮点数
.EnumFloat64(f []float64)

检查数据是否包含指定数据

// 示例：用户名必须是英文字母
zvalid.Text(data, "用户密码").StrongPassword("这里可以自定义错误信息，如：必须包含大小英文字母+符号并且长度为 6-20 位").String()

// 必须包含字母
.HasLetter()
// 必须包含小写字母
.HasLower()
// 必须包含大写字母
.HasUpper()
// 必须包含数字
.HasNumber()
// 必须包含符号
.HasSymbol()
// 必须包含特定的字符串
.HasString(str string)
// 必须包含指定前缀
.HasPrefix(str string)
// 必须包含指定后缀
.HasSuffix(str string)
// 6-20 位字符
.Password()
// 必须包含大小英文字母+符号并且长度为 6-20 位
.StrongPassword()
// 正则匹配
.RegexMatch(pattern string)

自定义处理

.Customize(func(rawValue string, err error) (newValue string, newErr error) {
    newValue = rawValue
    newErr = err
    return
})

数据处理

// 移除全部空格
.RemoveSpace()

结果集

// 赋值验证对象
valid := zvalid.Text(data, "用户名").Required("不能空值")

// 获取字符串
username, err := valid.String()

// 只获取结果字符串
username := valid.Value()

// 获取布尔值
b, err := valid.Bool()

// 获取整数
i, err := valid.Int()

// 获取整数
i, err := valid.Int()

// 获取浮点值
i, err := valid.Float64()

// 只获取是否验证通过
ok := valid.Ok()

// 只获取验证失败信息
err := valid.**Error()**