{"id":40762699,"url":"https://github.com/smokezl/govalidators","last_synced_at":"2026-01-21T17:09:36.869Z","repository":{"id":41413235,"uuid":"152204803","full_name":"smokezl/govalidators","owner":"smokezl","description":"struct 验证器，内置大部分常用验证，可自定义","archived":false,"fork":false,"pushed_at":"2020-10-30T11:29:41.000Z","size":23,"stargazers_count":57,"open_issues_count":2,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-13T18:42:00.013Z","etag":null,"topics":["golang","govalidator","struct","validation","validator"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smokezl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-09T07:12:31.000Z","updated_at":"2023-11-24T10:16:15.000Z","dependencies_parsed_at":"2022-09-02T06:20:13.542Z","dependency_job_id":null,"html_url":"https://github.com/smokezl/govalidators","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/smokezl/govalidators","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smokezl%2Fgovalidators","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smokezl%2Fgovalidators/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smokezl%2Fgovalidators/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smokezl%2Fgovalidators/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smokezl","download_url":"https://codeload.github.com/smokezl/govalidators/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smokezl%2Fgovalidators/sbom","scorecard":{"id":833734,"data":{"date":"2025-08-11","repo":{"name":"github.com/smokezl/govalidators","commit":"eee0660bbbe0fdee74bb3453e34fb56cdcfa46d0"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/11 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-23T18:25:22.436Z","repository_id":41413235,"created_at":"2025-08-23T18:25:22.436Z","updated_at":"2025-08-23T18:25:22.436Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28636813,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T15:01:31.228Z","status":"ssl_error","status_checked_at":"2026-01-21T14:42:58.942Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","govalidator","struct","validation","validator"],"created_at":"2026-01-21T17:09:36.804Z","updated_at":"2026-01-21T17:09:36.863Z","avatar_url":"https://github.com/smokezl.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"govalidators\n===========\ngolang初学者，在项目开发过程中造了一个简单的验证器轮子，欢迎大大们提宝贵建议和指导\n\n### 安装\n  go get github.com/smokezl/govalidators\n\n### 导入\n```go\nimport \"github.com/smokezl/govalidators\"\n```\n\n### 基本使用方式\n为 struct 指定验证器\n```go\npackage main\n\nimport \"github.com/smokezl/govalidators\"\n\ntype Class struct {\n  Cid       int64  `validate:\"required||integer=1,1000000\"`\n  Cname     string `validate:\"required||string=1,5||unique\"`\n  BeginTime string `validate:\"required||datetime=H:i\"`\n}\n\ntype Student struct {\n  Uid          int64    `validate:\"required||integer=1,1000000\"`\n  Name         string   `validate:\"required||string=1,5\"`\n  Age          int64    `validate:\"required||integer=10,30\"`\n  Sex          string   `validate:\"required||in=male,female\"`\n  Email        string   `validate:\"email\"`\n  PersonalPage string   `validate:\"url\"`\n  Hobby        []string `validate:\"array=_,2||unique||in=swimming,running,drawing\"`\n  CreateTime   string   `validate:\"datetime\"`\n  Class        []Class  `validate:\"array=1,3\"`\n}\n```\n验证\n```go\nvalidator := govalidators.New()\nif err := validator.Validate(student); err != nil {\n  fmt.Println(err)\n}\n```\n\n### 自定义验证器\n\n##### 1.支持自定义函数，必须是 ValidatorF 类型，ValidatorF 类型如下\n```go\ntype ValidatorF func(params map[string]interface{}, val reflect.Value, args ...string) (bool, error)\n```\n自定义函数\n```go\nfunc validationMethod(params map[string]interface{}, val reflect.Value, args ...string) (bool, error){\n  fmt.Println(\"validationMethod\")\n  ...\n  return true, nil\n}\n```\n##### 2.支持自定义struct，必须实现 Validator 接口，Validator 接口如下\n```go\ntype Validator interface {\n  Validate(params map[string]interface{}, val reflect.Value, args ...string) (bool, error)\n}\n```\n自定义struct\n```go\ntype UserValidator struct {\n  EMsg string\n}\n\nfunc (self *UserValidator) Validate(params map[string]interface{}, val reflect.Value, args ...string) (bool, error) {\n  fmt.Println(\"UserValidator\")\n  return true, nil\n}\n```\n##### 3.定义好验证器后，初始化验证器\n```go\nvalidator := govalidators.New()\nvalidator.SetValidators(map[string]interface{}{\n  \"user\" : \u0026UserValidator{},\n  \"vm\" : validationMethod,\n})\n```\n##### 4.在需要验证的字段中，增加自定义验证器\n```go\nEmail        string   `validate:\"email||user||vm\"`\n```\n##### 5.验证\n```go\nif err := validator.Validate(student); err != nil {\n  fmt.Println(err)\n}\n```\n##### 6.也可以对现有的验证器进行参数设置\n```go\nvalidator := govalidators.New()\nvalidator.SetValidators(map[string]interface{}{\n  \"string\": \u0026govalidators.StringValidator{\n      Range: govalidators.Range{\n        RangeEMsg: map[string]string{\n          \"between\": \"[name] 长度必须在 [min] 和 [max] 之间\",\n        },\n      },\n    },\n  \"datetime\": \u0026govalidators.DateTimeValidator{\n    FmtStr: \"Y-m-d\",\n  },\n  \"Email\": \u0026govalidators.EmailValidator{\n    Reg: `^(\\d)+$`,\n  },\n})\nif err := validator.Validate(student); err != nil {\n  fmt.Println(err)\n}\n```\n### 现有验证器介绍\n##### 1.涉及到判断范围(字符串长度、数组长度、数字大小)验证器的公共属性\n```go\ntype Range struct {\n  Min       string //最小值，外部可设置，支持0-9数字和 _ 符号，会将值赋值给 Range.min\n  Max       string //最大值，外部可设置，支持0-9数字和 _ 符号，会将值赋值给 Range.max\n  min       string //最小值，比对使用，支持0-9数字和 _ 符号，接收 Range.Min 和 struct 中传进来的值\n  max       string //最大值，比对使用，支持0-9数字和 _ 符号，接收 Range.Max 和 struct 中传进来的值\n\n  /**\n   * 自定义范围判断错误 msg 格式，map 的 keys 有 lessThan,equal,atLeast,between ,根据类型的不同，msg 文案也不同，[min] 表示 Range.min, [max] 表示 Range.max\n   * var stringErrorMap = map[string]string{\n   *   \"lessThan\": \"[name] should be less than [max] chars long\",\n   *   \"equal\":    \"[name] should be equal [min] chars long\",\n   *   \"atLeast\":  \"[name] should be at least [min] chars long\",\n   *   \"between\":  \"[name] should be betwween [min] and [max] chars long\",\n   * }\n   * var numberErrorMap = map[string]string{\n   *   \"lessThan\": \"[name] should be less than [max]\",\n   *   \"equal\":    \"[name] should be equal [min]\",\n   *   \"atLeast\":  \"[name] should be at least [min]\",\n   *   \"between\":  \"[name] should be betwween [min] and [max]\",\n   * }\n   * var arrayErrorMap = map[string]string{\n   *   \"lessThan\": \"array [name] length should be less than [max]\",\n   *   \"equal\":    \"array [name] length should be equal [min]\",\n   *   \"atLeast\":  \"array [name] length should be at least [min]\",\n   *   \"between\":  \"array [name] length should be betwween [min] and [max]\",\n   * }\n   */\n  RangeEMsg map[string]string \n}\n```\n##### 2.required，判断属性值是否为对应类型的零值\n```go\ntype RequiredValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is must required，[name] 表示属性名，下同\n}\n```\n##### 3.string(=_,n/=n,m,=n,=n,_)，判断属性值是否是字符串类型；如果后边接 = 参数，还会判断字符串长度是否合法\n```go\ntype StringValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is not a string\n  Range       //涉及到判断范围(字符串长度、数组长度、数字大小)验证器的公共属性\n}\n```\n##### 4.integer(=_,n/=n,m,=n,=n,_)，判断属性值是否是整数类型；如果后边接 = 参数，还会判断整数值是否合法\n```go\ntype IntegerValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is not a integer\n  Range       //涉及到判断范围(字符串长度、数组长度、数字大小)验证器的公共属性\n}\n```\n##### 5.array(=_,n/=n,m,=n,=n,_)，判断属性值是否是 map/slice/array 类型；如果后边接 = 参数，还会判断其长度是否合法\n```go\ntype ArrayValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is not a array/map/slice\n  Range       //涉及到判断范围(字符串长度、数组长度、数字大小)验证器的公共属性\n}\n```\n##### 6.email，判断属性值是否是合法 email\n```go\ntype EmailValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is not a email address\n  Reg  string //自定义 email 正则\n}\n```\n##### 7.url，判断属性值是否是合法 url\n```go\ntype UrlValidator struct{\n  EMsg string //自定义错误 msg 格式，默认为 [name] is not a url\n  Reg  string //自定义 url 正则\n}\n```\n##### 8.in=?,?,?,?...，判断属性值是否在 in 后边定义的值中，仅支持 string、float、int、bool 类型或值类型为 string、float、int、bool 类型的array、slice、map\n```go\ntype InValidator struct{\n  EMsg string       //自定义错误 msg 格式，默认为 [name] is not in params [args]\n  TypeEMsg  string  //自定义类型错误 msg 格式，默认为 [name] type invalid\n}\n```\n##### 9.datetime(=Y m d H i s)，判断属性值是否属于日期格式，可以自定义 Y m d H i s 的组合，如 Y-m-d、Y/m/d H:i:s、Y-m-d H:i:s\n```go\ntype DateTimeValidator struct{\n  EMsg string       //自定义错误 msg 格式，默认为 [name] is not a date time\n  FmtStr  string  //自定义Y m d H i s 组合，默认为 Y-m-d H:i:s\n}\n```\n##### 10.unique,判断属性值是否是唯一的，仅支持 string、float、int、bool 类型或值类型为 string、float、int、bool 类型的array、slice、map\n```go\ntype UniqueValidator struct{\n  EMsg string       //自定义错误 msg 格式，默认为 [name] is not unique\n}\n```\n\n### 方法介绍\n##### 1.func(goValidator)SetTag，设置 struct tag 中，验证标识，默认为 validate\n```go\nfunc (self *goValidator) SetTag(tag string) *goValidator\n```\n\n##### 2.func (goValidator)SetSkipOnStructEmpty，设置如果对应的值为空(零值)，跳过验证，默认为 true\n```go\nfunc (self *goValidator) SetSkipOnStructEmpty(skip bool) *goValidator\n```\n\n##### 3.func (goValidator) SetValidatorSplit(str string)，设置 struct tag 中，验证器分隔符，默认为 ||\n```go\nfunc (self *goValidator) SetValidatorSplit(str string) *goValidator\n```\n\n##### 4.func (goValidator) SetValidator(validatorK string, validator interface{})，设置自定义验证器，验证器必须满足 ValidatorF 类型或实现 Validator 接口\n```go\nfunc (self *goValidator) SetValidator(validatorK string, validator interface{}) *goValidator\n```\n\n##### 5.func (goValidator) SetValidators(validatorMap map[string]interface{})，批量设置自定义验证器，验证器必须满足 ValidatorF 类型或实现 Validator 接口\n```go\nfunc (self *goValidator) SetValidators(validatorMap map[string]interface{}) *goValidator \n``` \n\n##### 6.func (goValidator) LazyValidate(s interface{})，对 struct 进行验证，如果出现错误，不继续执行，并将错误返回\n```go\nfunc (self *goValidator) LazyValidate(s interface{}) (err error) \n```\n\n##### 7.func (goValidator) Validate(s interface{})，对 struct 进行验证，如果出现错误，会继续执行，并将错误全部返回\n```go\nfunc (self *goValidator) Validate(s interface{}) (err []error) \n```\n\nMIT licence.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmokezl%2Fgovalidators","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmokezl%2Fgovalidators","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmokezl%2Fgovalidators/lists"}