Update README.md
This commit is contained in:
guanguans
parent
7526156f27
commit
7afae50ae9
121
README-ES.md
Normal file
121
README-ES.md
Normal file
@ -0,0 +1,121 @@
|
|||||||
|
# id-validator
|
||||||
|
|
||||||
|
[简体中文](README.md) | [ENGLISH](README-ES.md)
|
||||||
|
|
||||||
|
> China ID number verification.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
* China ID number verification
|
||||||
|
* Get ID number information
|
||||||
|
* Upgrade 15-digit ID number to 18
|
||||||
|
* Forged ID number that meets the verification
|
||||||
|
|
||||||
|
## Requirement
|
||||||
|
|
||||||
|
* Go >= 1.11
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
``` shell script
|
||||||
|
$ go get -u github.com/guanguans/id-validator
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
This is just a quick introduction, view the [GoDoc](https://godoc.org/github.com/guanguans/id-validator) for details.
|
||||||
|
|
||||||
|
Let's start with a trivial example:
|
||||||
|
|
||||||
|
``` go
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
idvalidator "github.com/guanguans/id-validator"
|
||||||
|
"gopkg.in/ffmt.v1"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
|
||||||
|
// 验证身份证号合法性
|
||||||
|
ffmt.P(idvalidator.IsValid("440308199901101512")) // 大陆居民身份证18位
|
||||||
|
ffmt.P(idvalidator.IsValid("610104620927690")) // 大陆居民身份证15位
|
||||||
|
ffmt.P(idvalidator.IsValid("810000199408230021")) // 港澳居民居住证18位
|
||||||
|
ffmt.P(idvalidator.IsValid("830000199201300022")) // 台湾居民居住证18位
|
||||||
|
|
||||||
|
// 获取身份证号信息
|
||||||
|
ffmt.P(idvalidator.GetInfo("440308199901101512"))
|
||||||
|
// []interface {}[
|
||||||
|
// github.com/guanguans/id-validator.IdInfo{ // 身份证号信息
|
||||||
|
// AddressCode: int(440308) // 地址码
|
||||||
|
// Abandoned: int(0) // 地址码是否废弃：1为废弃的，0为正在使用的
|
||||||
|
// Address: string("广东省深圳市盐田区") // 地址
|
||||||
|
// AddressTree: []string[ // 省市区三级列表
|
||||||
|
// string("广东省") // 省
|
||||||
|
// string("深圳市") // 市
|
||||||
|
// string("盐田区") // 区
|
||||||
|
// ]
|
||||||
|
// Birthday: <1999-01-10 00:00:00 +0000 UTC> // 出生日期
|
||||||
|
// Constellation: string("摩羯座") // 星座
|
||||||
|
// ChineseZodiac: string("卯兔") // 生肖
|
||||||
|
// Sex: int(1) // 性别：1为男性，0为女性
|
||||||
|
// Length: int(18) // 号码长度
|
||||||
|
// CheckBit: string("2") // 校验码
|
||||||
|
// }
|
||||||
|
// <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> // 错误信息
|
||||||
|
// ]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Testing
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
$ go test
|
||||||
|
```
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
|
||||||
|
|
||||||
|
## Security Vulnerabilities
|
||||||
|
|
||||||
|
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
|
||||||
|
|
||||||
|
## Credits
|
||||||
|
|
||||||
|
* [guanguans](https://github.com/guanguans)
|
||||||
|
* [All Contributors](../../contributors)
|
||||||
|
|
||||||
|
## Related projects
|
||||||
|
|
||||||
|
* [jxlwqq/id-validator](https://github.com/jxlwqq/id-validator), by jxlwqq
|
||||||
|
* [jxlwqq/id-validator.py](https://github.com/jxlwqq/id-validator.py), by jxlwqq
|
||||||
|
* [mc-zone/IDValidator](https://github.com/mc-zone/IDValidator), by mc-zone
|
||||||
|
* [renyijiu/id_validator](https://github.com/renyijiu/id_validator), by renyijiu
|
||||||
|
|
||||||
|
## Reference material
|
||||||
|
|
||||||
|
* [People's Republic of China citizenship number](https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码)
|
||||||
|
* [Ministry of Civil Affairs of the People's Republic of China: Administrative division code](http://www.mca.gov.cn/article/sj/xzqh/)
|
||||||
|
* [Historical data set of administrative division codes of the People's Republic of China](https://github.com/jxlwqq/address-code-of-china)
|
||||||
|
* [Notice of the General Office of the State Council on Issuing the Measures for the Application and Issuance of Residence Permits for Hong Kong, Macao and Taiwan Residents](http://www.gov.cn/zhengce/content/2018-08/19/content_5314865.htm)
|
||||||
|
* [Residence Permit for Hong Kong, Macao and Taiwan Residents](https://zh.wikipedia.org/wiki/港澳台居民居住证)
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
The MIT License (MIT). Please see [License File](LICENSE) for more information.
|
||||||
53
README.md
53
README.md
@ -1,29 +1,36 @@
|
|||||||
# id-validator
|
# id-validator
|
||||||
|
|
||||||
> 中国身份证号验证、获取身份证号信息、升级 15 位身份证号为 18 位、伪造符合校验的身份证号。
|
[简体中文](README.md) | [ENGLISH](README-ES.md)
|
||||||
|
|
||||||
|
> 中国身份证号验证。
|
||||||
|
|
||||||
[](https://github.com/guanguans/id-validator/actions)
|
[](https://github.com/guanguans/id-validator/actions)
|
||||||
[](https://gocover.io/github.com/guanguans/id-validator)
|
[](https://gocover.io/github.com/guanguans/id-validator)
|
||||||
[](https://goreportcard.com/report/github.com/guanguans/id-validator)
|
[](https://goreportcard.com/report/github.com/guanguans/id-validator)
|
||||||
[](https://godoc.org/github.com/guanguans/id-validator)
|
[](https://godoc.org/github.com/guanguans/id-validator)
|
||||||
[](https://github.com/guanguans/id-validator/releases)
|
[](https://github.com/guanguans/id-validator/releases)
|
||||||
[](https://github.com/guanguans/id-validator/blob/master/LICENSE)
|
[](https://github.com/guanguans/id-validator/blob/master/LICENSE)
|
||||||
|
|
||||||
## Requirement
|
## 功能
|
||||||
|
|
||||||
|
* 中国身份证号验证
|
||||||
|
* 获取身份证号信息
|
||||||
|
* 升级 15 位身份证号为 18 位
|
||||||
|
* 伪造符合校验的身份证号
|
||||||
|
|
||||||
|
## 环境要求
|
||||||
|
|
||||||
* Go >= 1.11
|
* Go >= 1.11
|
||||||
|
|
||||||
## Installation
|
## 安装
|
||||||
|
|
||||||
``` shell script
|
``` shell script
|
||||||
$ go get -u github.com/guanguans/id-validator
|
$ go get -u github.com/guanguans/id-validator
|
||||||
```
|
```
|
||||||
|
|
||||||
## Usage
|
## 使用
|
||||||
|
|
||||||
This is just a quick introduction, view the [GoDoc](https://godoc.org/github.com/guanguans/id-validator) for details.
|
这只是一个快速介绍, 请查看 [GoDoc](https://godoc.org/github.com/guanguans/id-validator) 获得详细信息。
|
||||||
|
|
||||||
Let's start with a trivial example:
|
|
||||||
|
|
||||||
``` go
|
``` go
|
||||||
package main
|
package main
|
||||||
@ -76,35 +83,35 @@ func main() {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
## Testing
|
## 测试
|
||||||
|
|
||||||
``` bash
|
``` bash
|
||||||
$ go test
|
$ go test
|
||||||
```
|
```
|
||||||
|
|
||||||
## Changelog
|
## 变更日志
|
||||||
|
|
||||||
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
|
请参阅 [CHANGELOG](CHANGELOG.md) 获取最近有关更改的更多信息。
|
||||||
|
|
||||||
## Contributing
|
## 贡献指南
|
||||||
|
|
||||||
Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
|
请参阅 [CONTRIBUTING](.github/CONTRIBUTING.md) 有关详细信息。
|
||||||
|
|
||||||
## Security Vulnerabilities
|
## 安全漏洞
|
||||||
|
|
||||||
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
|
请查看[我们的安全政策](../../security/policy)了解如何报告安全漏洞。
|
||||||
|
|
||||||
## Credits
|
## 贡献者
|
||||||
|
|
||||||
* [guanguans](https://github.com/guanguans)
|
* [guanguans](https://github.com/guanguans)
|
||||||
* [All Contributors](../../contributors)
|
* [所有贡献者](../../contributors)
|
||||||
|
|
||||||
## 相关项目
|
## 相关项目
|
||||||
|
|
||||||
* [PHP 版本](https://github.com/jxlwqq/id-validator)
|
* [jxlwqq/id-validator](https://github.com/jxlwqq/id-validator)，jxlwqq
|
||||||
* [Python 版本](https://github.com/jxlwqq/id-validator.py)
|
* [jxlwqq/id-validator.py](https://github.com/jxlwqq/id-validator.py)，jxlwqq
|
||||||
* [Ruby 版本](https://github.com/renyijiu/id_validator)
|
* [mc-zone/IDValidator](https://github.com/mc-zone/IDValidator)，mc-zone
|
||||||
* [JavaScript 版本](https://github.com/mc-zone/IDValidator)
|
* [renyijiu/id_validator](https://github.com/renyijiu/id_validator)，renyijiu
|
||||||
|
|
||||||
## 参考资料
|
## 参考资料
|
||||||
|
|
||||||
@ -114,6 +121,6 @@ Please review [our security policy](../../security/policy) on how to report secu
|
|||||||
* [国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知](http://www.gov.cn/zhengce/content/2018-08/19/content_5314865.htm)
|
* [国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知](http://www.gov.cn/zhengce/content/2018-08/19/content_5314865.htm)
|
||||||
* [港澳台居民居住证](https://zh.wikipedia.org/wiki/港澳台居民居住证)
|
* [港澳台居民居住证](https://zh.wikipedia.org/wiki/港澳台居民居住证)
|
||||||
|
|
||||||
## License
|
## 协议
|
||||||
|
|
||||||
The MIT License (MIT). Please see [License File](LICENSE) for more information.
|
MIT 许可证（MIT）。有关更多信息，请参见[协议文件](LICENSE)。
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user