大陆居民身份证、港澳台居民居住证 Composer 包:验证、获取基本信息以及生成假数据

地址:https://github.com/jxlwqq/id-validator

IdValidator.php

中华人民共和国居民身份证中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具(PHP Composer 版)支持 15 位与 18 位号码。基于 JavaScript 版本

安装

composer require "jxlwqq/id-validator"

使用

440308199901101512610104620927690 示例大陆居民身份证均为随机生成的假数据,如撞车,请联系删除。
810000199408230021830000199201300022 示例港澳台居民居住证为北京市公安局公布的居住证样式号码。

验证身份证号合法性

验证身份证号是否合法,合法返回 true,不合法返回 false:

use Jxlwqq\IdValidator\IdValidator;

$idValidator = new IdValidator();
$idValidator->isValid('440308199901101512'); // 大陆居民身份证 18 位
$idValidator->isValid('610104620927690');    // 大陆居民身份证 15 位
$idValidator->isValid('810000199408230021'); // 港澳居民居住证 18 位
$idValidator->isValid('830000199201300022'); // 台湾居民居住证 18 位

获取身份证号信息

当身份证号合法时,返回分析信息(地区、出生日期、星座、生肖、性别、校验位),不合法返回 false:

use Jxlwqq\IdValidator\IdValidator;

$idValidator = new IdValidator();
$idValidator->getInfo('440308199901101512'); // 18 位
$idValidator->getInfo('610104620927690');    // 15 位

返回信息格式:

[
'addressCode'   => '440308',          // 地址码   
'abandoned'     => 0,                 // 地址码是否废弃,1 为废弃的,0 为正在使用的
'address'       => '广东省深圳市盐田区', // 地址
'birthdayCode'  => '1999-01-10',      // 出生日期
'constellation' => '水瓶座',           // 星座
'chineseZodiac' => '卯兔',             // 生肖
'sex'           => 1,                 // 性别,1 为男性,0 为女性
'length'        => 18,                // 号码长度
'checkBit'      => '2',               // 校验码
]

生成可通过校验的假数据

伪造符合校验的身份证:

fakeId() 方法有 4 个可选参数:

  • $eighteen 是否生成 18 位号码,默认为 true
  • $address 地址,即省市县三级地区官方全称,如北京市台湾省香港特别行政区深圳市黄浦区等,默认或参数非法,则生成合法的随机地址;
  • $birthday 出生日期,如 200019880119990101 等,默认或参数非法,则生成合法的随机出生日期;
  • $sex 性别,1 为男性,0 为女性,默认或参数非法,则生成合法的随机性别;
use Jxlwqq\IdValidator\IdValidator;

$idValidator = new IdValidator();
$idValidator->fakeId();                             // 18 位
$idValidator->fakeId(false);                        // 15 位
$idValidator->fakeId(true, '上海市', '2000', 1);     // 生成出生于 2000 年上海市的男性居民身份证
$idValidator->fakeId(true, '南山区', '1999', 0);     // 生成出生于 1999 年深圳市南山区的女性居民身份证
$idValidator->fakeId(true, '江苏省', '200001', 1));  // 生成出生于 2000 年 1 月江苏省的男性居民身份证
$idValidator->fakeId(true, '台湾省', '20131010', 0); // 生成出生于 2013 年 10 月 10 日台湾省的女性居民居住证
$idValidator->fakeId(true, '香港特别行政区', '19970701', 0); // 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证

参考资料

Change Log

  • 1.1.0 身份证号返回信息新增生肖和星座内容;

  • 1.2.0 支持港澳台居民居住证;

  • 1.3.0 行政区划代码(地址码)数据改由从中华人民共和国民政部官方网站获取;

  • 1.4.0 支持查询因行政区变更而废弃的地址码;

  • 1.4.2 fakeId() 方法增加可选参数;

License

MIT

本作品采用《CC 协议》,转载必须注明作者和本文链接
本帖由 Summer 于 5年前 加精
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 14

支持最新的港澳台居民居住证哦!

5年前 评论
在获取星座信息时,月份变量进行减法运算后无法正确获取到星座数据中的值
另外就是中国国内由于行政区划分存在变动,身份证号却是不存在变动,所以很多老一辈的身份证没法识别,比如重庆地区,我父母的前3位为512,而我是500
5年前 评论

建议把老的区域代码也加上,这样这样更全面一些。我没仔细看过,不过感觉改过区域代码的地区以前的代码应该会保留,不会给其他区域使用,只要没冲突其实就行。

5年前 评论

@陈静 谢谢反馈。
问题一:已修复。
问题二:需要写一个爬虫,爬取历史数据并比对。周末我加上哈。

5年前 评论

@陈静 支持因行政区变更而废弃的地址码啦。详见:https://github.com/jxlwqq/id-validator/com...

5年前 评论

$idValidator->fakeId(); 能否增加参数指定性别、年龄范围等

5年前 评论

@雪风 可以的,后续迭代中添加此功能。谢谢反馈。

5年前 评论

@雪风 已经支持,请更新到最新版本。

5年前 评论
Uees

非常棒,这个能用来做什么用途

5年前 评论

@Uees 例如游戏注册,用户需要提交身份证信息,而身份证实名验证一般都要调用第三方付费接口,这个包可以放置实名验证之前,过滤掉一些不符合逻辑的假身份证,减少费用。

5年前 评论

我上周五才自己写了一个生成假身份证的代码,早知道你写了我就直接拿来用了,,,,,

5年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!