guanguans / id-validator Goto Github PK

China ID number validator. - **身份证号验证器。

License: MIT License

Go 99.20% Makefile 0.04% PHP 0.76%

verify id idcard idcard-check idcard-generator idcard-detect idcardnumber-validation idcardocr-china validate validation

id-validator's Introduction

id-validator

简体中文 | ENGLISH

China ID number validator. - **身份证号验证器。

功能

验证**身份证号
获取身份证号信息
升级 15 位身份证号为 18 位
伪造符合校验的身份证号

环境要求

Go >= 1.14

安装

$ go get -u github.com/guanguans/id-validator

使用

这只是一个快速介绍, 请查看 GoDoc 获得详细信息。

package main

import (
    idvalidator "github.com/guanguans/id-validator"
    "gopkg.in/ffmt.v1"
)

func main() {
    // 验证身份证号合法性
    ffmt.P(idvalidator.IsValid("500154199301135886", true))  // 严格模式验证大陆居民身份证18位
    ffmt.P(idvalidator.IsValid("500154199301135886", false)) // 非严格模式验证大陆居民身份证18位
    ffmt.P(idvalidator.IsValid("11010119900307803X", false)) // 大陆居民身份证末位是X18位
    ffmt.P(idvalidator.IsValid("610104620927690", false))    // 大陆居民身份证15位
    ffmt.P(idvalidator.IsValid("810000199408230021", false)) // 港澳居民居住证18位
    ffmt.P(idvalidator.IsValid("830000199201300022", false)) // **居民居住证18位

    // 获取身份证号信息
    ffmt.P(idvalidator.GetInfo("500154199301135886", true))  // 严格模式获取身份证号信息
    ffmt.P(idvalidator.GetInfo("500154199301135886", false)) // 非严格模式获取身份证号信息
    // []interface {}[
    //     github.com/guanguans/id-validator.IdInfo{          // 身份证号信息
    //         AddressCode: int(500154)                           // 地址码
    //         Abandoned:   int(0)                                // 地址码是否废弃：1为废弃的，0为正在使用的
    //         Address:     string("重庆市市辖区开州区")             // 地址
    //         AddressTree: []string[                             // 省市区三级列表
    //             string("重庆市")                                    // 省
    //             string("市辖区")                                    // 市
    //             string("开州区")                                    // 区
    //         ]
    //         Birthday:      <1993-01-13 00:00:00 +0800 CST>     // 出生日期
    //         Constellation: string("摩羯座")                     // 星座
    //         ChineseZodiac: string("酉鸡")                       // 生肖
    //         Sex:           int(0)                              // 性别：1为男性，0为女性
    //         Length:        int(18)                             // 号码长度
    //         CheckBit:      string("6")                         // 校验码
    //     }
    //     <nil>                                              // 错误信息
    // ]

    // 生成可通过校验的假身份证号
    ffmt.P(idvalidator.FakeId())                                  // 随机生成
    ffmt.P(idvalidator.FakeRequireId(true, "江苏省", "200001", 1)) // 生成出生于2000年1月江苏省的男性居民身份证

    // 15位号码升级为18位
    ffmt.P(idvalidator.UpgradeId("610104620927690"))
    // []interface {}[
    // 	string("610104196209276908") // 升级后号码
    // 	<nil>                        // 错误信息
    // ]
}

测试

$ make test

变更日志

请参阅 CHANGELOG 获取最近有关更改的更多信息。

贡献指南

请参阅 CONTRIBUTING 有关详细信息。

安全漏洞

请查看我们的安全政策了解如何报告安全漏洞。

贡献者

参考资料

协议

MIT 许可证（MIT）。有关更多信息，请参见协议文件。

id-validator's People

Contributors

Stargazers

Watchers

id-validator's Issues

身份证校验不准确&&调试模式无法开启

举个例子：320819197004124810 invalid ID card number

调试模式异常：
/Users/mac/go/pkg/mod/github.com/guanguans/[email protected]/data/constellation.go:64:6: internal compiler error: NewBulk too big: nbit=63108 count=883526 nword=1973 size=1743196798

Please file a bug report including a short program that triggers the error.
https://golang.org/issue/new

230119开头号段不通过验证

320219开头的身份证号会校验不通过

bug现象
所有320219开头的身份证号均会校验不通过

原因
addressCodeTimelineJiangSu函数中缺失320219相关信息

编译异常

go version: 1.17

E:\go\pkg\mod\github.com\guanguans\[email protected]\data\constellation.go:64:6: internal compiler error: NewBulk too big: nbit=63108 count=883526 nword=1973 size=1743196798

goland下不能进行debug模式

Describe the bug
goland调试模式下报错

To Reproduce
goland下进行debug

Expected behavior
能够正常调试程序

Screenshots

Additional context
无

internal compiler error: NewBulk too big

刚使用go没几天所有不能给你太多的描述了/(ㄒoㄒ)/~~

尾号是X的好像不能验证

如题，带X的不能验证通过，如：11010119900307803X

docker下build程序，会被killed

#12 51.29 go build github.com/guanguans/id-validator/data: /usr/local/go/pkg/tool/linux_amd64/compile: signal: killed

dlv模式下内存问题

dlv模式下会导致compile进程内存飙升

可以加个年龄吗

您好，请问严格模式与非严格具体什么区别？另外地址区划代码与年份不同的错误身份证能否校验出来？

// 验证身份证号合法性严格模式与非严格具体什么区别？
ffmt.P(idvalidator.IsValid("440308199901101512", false)) // 非严格模式验证大陆居民身份证18位
ffmt.P(idvalidator.IsValid("440308199901101512", true)) // 严格模式验证大陆居民身份证18位

关于校验地址码有效期功能：
例如假身份证号370620199505100123，但是1995年威海地区压根没有370620的地址区划代码。（前六位地址码错误，370620地址码在1987年就废弃了）

addressTree 这种写法不能保证地区信息的可靠性吧省市区的顺序可能会发生变化

// 地址信息
addressInfo := getAddressInfo(code["addressCode"], code["birthdayCode"], strict)
var addressTree []string
for _, val := range addressInfo {
addressTree = append(addressTree, val)
}

江苏身份证号以321119开头验证失败

江苏地区尾号为19也需要特殊处理
addressCodeTimelineJiangSu中没有321119集合
为空的情况下只处理了01、02、11、20情况

/darwin_arm64/compile: signal: killed

调试代码的时候报错，16G内存都不够

容易发生panic

func Test02(t *testing.T) {
	t.Log(idvalidator.IsLooseValid("010-12345678转152"))
}

stack

--- FAIL: Test02 (0.00s)
panic: runtime error: index out of range [1] with length 0 [recovered]
	panic: runtime error: index out of range [1] with length 0

goroutine 8 [running]:
github.com/guanguans/id-validator.generateLongCode({0xd6f66c, 0x12})
	/home/xxx/go/pkg/mod/github.com/guanguans/[email protected]/checker.go:58 +0x385
github.com/guanguans/id-validator.generateCode({0xd6f66c?, 0xfb502c?})
	/home/xxx/go/pkg/mod/github.com/guanguans/[email protected]/checker.go:24 +0x31
github.com/guanguans/id-validator.IsValid({0xd6f66c?, 0x520a74?}, 0x0?)
	/home/xxx/go/pkg/mod/github.com/guanguans/[email protected]/id_validator.go:32 +0x26
github.com/guanguans/id-validator.IsLooseValid(...)
	/home/xx/go/pkg/mod/github.com/guanguans/[email protected]/id_validator.go:53

如果身份证‘order’是以0开头在使用cast.ToInt时会变成0导致性别判断不准确

引入该依赖后静态编译速度变慢、debug无法启动，报堆栈溢出

mac intel/m1 均有此问题。