douyasi/identity-card
Stars: 171
Forks: 38
Pull Requests: 9
Issues: 6
Watchers: 9
Last Updated: 2023-04-27 03:43:14
Chinese Identity Card package （中国大陆）公民身份证类
License: MIT License
Languages: PHP
中国（大陆）公民身份证类
中国（大陆）公民身份证类包，数据来自国标
GB/T 2260-2007(中华人民共和国行政区划代码 标准) 。
其它语言实现版本
- Node/Javascript 实现版本
- Rust 实现版本
- 扩展与延伸：省市县三级联动地址效果，使用的是最新
2021年数据，需要做额外转换，转换好之后的 JS 文件大小约为99KB，可以点 此 查看。
版本更新记录
- 2016年期间，发布
1.0-1.2版本，数据来自GB/T 2260-2007标准，使用PHP内置数组存储。 - 2017年05月26日，发布
2.x系列初版2.0版本，开始使用SQLite作为数据存储源，并公布采集脚本。 - 2017年09月，发布
2.2-2.4版本，修复某些情况下返回地区（主要县级）信息为空、不准确的问题。 - 2017年12月03日，发布
2.4版本，修复返回错误星座问题。 - 2018年03月27日，发布
2.5版本，采集截止2018年01月的行政区划数据。 - 2018年05月13日，发布
2.6版本，更新其他语言实现，如Node/Javascript·与Rust。 - 2019年03月31日，发布
2.7版本，采集截止到2019年02月的行政区划数据，并修复错误年龄问题。下次（数据库）更新，预计在2020年03月底。 - 2020年06月29日，发布
2.8版本，采集截止到2020年02月（可能受疫情影响，民政部官网也只更新到该月份）的行政区划数据。 - 2020年10月10日，发布
2.9版本，采集截止到2020年08月的行政区划数据，同时移除采集脚本和历史归档数据（已剥离到 china-divisions 新项目中），下次数据库与版本更新预计在2021年04月底。 - 2023年02月08日，发布
2.10版本，采集并人工处理截止到2021年的行政区划数据。一直未发布新版本，原因并不在作者我，民政部数据源头在最近2年多更新很不及时，参考此说明。
安装说明
在 composer 中添加依赖：
"require": {
"douyasi/identity-card": "~2.0"
}然后在命令行窗体里执行 composer update 命令，或者参考下面直接使用 composer require 命令：
cd /path/to/your-project
composer require "douyasi/identity-card:~2.0"特别提示：
本插件需要使用 PDO 连接 sqlite 数据库，故需要安装和开启 pdo 和 pdo_sqlite 组件。
使用说明
Laravel 示例代码
创建ID类的实例，然后调用其对应方法。Laravel 测试路由示例：
Route::get('test', function() {
$ID = new Douyasi\IdentityCard\ID();
$pid = '42032319930606629x';
$passed = $ID->validateIDCard($pid);
$area = $ID->getArea($pid);
$gender = $ID->getGender($pid);
$birthday = $ID->getBirth($pid);
$age = $ID->getAge($pid);
$constellation = $ID->getConstellation($pid);
return compact('passed', 'area', 'gender', 'birthday', 'age', 'constellation');
});结果集
上面测试路由将返回下面 json 数据响应：
{
"status": true,
"result": {
"is_pass": true,
"area": {
"status": true,
"result": "湖北省 十堰市竹山县",
"province": "湖北省",
"city": "十堰市",
"county": "竹山县",
"using": 1
},
"gender": "m",
"birthday": "1993-06-06",
"age": 23,
"constellation": "双子座"
}
}如果身份证证号校验通过，
passed返回true，否则返回false。其它字段（如eara、gender、birthday、age和constellation）顾名思义，就不做解释了。
2.0+版本getArea()方法返回中新增using字段，表示行政区划代码当前是否还在使用中。如果为1，说明此身份证证号前6位数字代码（也就是行政区划代码，如420323）仍在使用，可以新签发（非续签非补办）此行政区划代码打头的身份证；为0表示行政区划已经发生变更（地名可能不变），不再新签发此行政区划代码打头的身份证。
API列表
validateIDCard()获取身份证号码校验结果；getArea()获取身份证号码原始地区信息；getGender()获取性别，m男性f女性；getBirth()获取出生年月日；getAge()获取年龄；getConstellation()获取星座。
关于星座月日范围，会有上下
1-2天的浮动，这里以维基百科资料为主。 维基百科地址： https://zh.wikipedia.org/wiki/%E8%A5%BF%E6%B4%8B%E5%8D%A0%E6%98%9F%E8%A1%93 .
'水瓶座', // 1.21-2.19 [Aquarius]
'双鱼座', // 2.20-3.20 [Pisces]
'白羊座', // 3.21-4.19 [Aries]
'金牛座', // 4.20-5.20 [Taurus]
'双子座', // 5.21-6.21 [Gemini]
'巨蟹座', // 6.22-7.22 [Cancer]
'狮子座', // 7.23-8.22 [Leo]
'处女座', // 8.23-9.22 [Virgo]
'天秤座', // 9.23-10.23 [Libra]
'天蝎座', // 10.24-11.21 [Scorpio]
'射手座', // 11.22-12.20 [Sagittarius]
'魔羯座', // 12.21-1.20 [Capricorn]
数据爬虫
请参考 china-divisions 项目 crawler 目录下 readme 文件。
参考资源
- 中华人民共和国国家统计局 行政区划代码
- 民政部 县级以上行政区划变更情况
- 民政部 中华人民共和国行政区划代码
