• Stars
    star
    673
  • Rank 67,060 (Top 2 %)
  • Language
    PHP
  • License
    MIT License
  • Created about 6 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具(PHP 版)

IdValidator.php

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

Testing StyleCI Scrutinizer Code Quality Maintainability FOSSA Status 996.icu

安装

composer require "jxlwqq/id-validator"

注:如果 require 失败,解决方案见 #13

使用

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'       => '广东省深圳市盐田区',           // 地址
    'addressTree'   => ['广东省', '深圳市', '盐田区'], // 省市区三级列表
    'birthdayCode'  => '1999-01-10',                // 出生日期
    'constellation' => '水瓶座',                     // 星座
    'chineseZodiac' => '卯兔',                       // 生肖
    'sex'           => 1,                           // 性别,1 为男性,0 为女性
    'length'        => 18,                          // 号码长度
    'checkBit'      => '2',                         // 校验码
]

注:判断地址码是否废弃的依据是中华人民共和国行政区划代码历史数据集,本数据集的采集源来自:中华人民共和国民政部,每年更新一次。本数据集采用 csv 格式存储,方便大家进行数据分析或者开发其他语言的版本。

生成可通过校验的假数据

伪造符合校验的身份证:

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, '厦门市', '199701', 0);          // 生成出生于 1997 年 1 月福建省厦门市的女性居民身份证
$idValidator->fakeId(true, '台湾省', '20131010', 0);        // 生成出生于 2013 年 10 月 10 日台湾省的女性居民居住证
$idValidator->fakeId(true, '香港特别行政区', '19970701', 0); // 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证

升级身份证号码

15 位号码升级为 18 位:

use Jxlwqq\IdValidator\IdValidator;

$idValidator = new IdValidator();
$idValidator->upgradeId('610104620927690'); // 15 位号码升级为 18 位

参考资料

Change Log

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

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

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

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

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

  • 1.4.11 支持 15 位身份证号码升级为 18 位;

  • 1.4.18 getInfo() 返回值新增省市区三级列表

License

MIT

More Repositories

1

id-validator.py

中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具(Python 版)
Python
357
star
2

awesome-laravel-admin

A curated list of Laravel-admin resources
220
star
3

kubernetes-examples

Kubernetes 经典示例
Go
217
star
4

blog-microservices

A blog microservices written in Golang, which can be deployed in an Istio-enabled kubernetes cluster.
Go
189
star
5

chinese-typesetting

📄 中文排版 Composer 包
PHP
85
star
6

address-code-of-china

中华人民共和国行政区划代码/身份证地址码
36
star
7

php2python

Python alternatives for PHP internal (built-in) functions.
Python
19
star
8

cloud-native-reading-list

精选云原生相关的阅读列表(包含博客、专栏、书籍、视频等)
18
star
9

grpc-lb

Kubernetes 中的 gRPC 负载均衡
Go
14
star
10

installing-solr-and-indexing-mysql-on-macos

在 macOS 上安装 Solr 并索引 MySQL
11
star
11

http-echo

HTTP Echo is a go web server that echos back the arguments given to it. Multi-platform supported.
Go
9
star
12

learn-docker-and-k8s

Docker 与 Kubernetes 学习笔记
JavaScript
6
star
13

percona-toolkit-document

MySQL 管理工具包 Percona Toolkit 中文翻译文档
5
star
14

git-teching

HTML
4
star
15

memcached-operator

memcached operator
Go
4
star
16

english-proper-nouns

English nouns that indicate individual entities, such as names of persons, places or organizations.
Python
4
star
17

yii2-admin

后台内容管理系统
PHP
4
star
18

todo

Todolist microservice with Istio
Go
3
star
19

cnat-operator

Go
3
star
20

visitors-operator

Go
3
star
21

php-dev-on-macos

2
star
22

wordpress-operator

Go
2
star
23

house_price_index

Python
2
star
24

My_Local_PHP_Development_Environment_On_MacOS_Sierra_11.12

1
star
25

guestbook-operator

「Kubernetes 官方示例:使用 Redis 部署 PHP 留言板应用程序」Operator 化。
Go
1
star
26

synonyms-api

Python
1
star
27

Metro-UI-CSS-CN

Metro-UI-CSS 中文版/中文翻译 创建Windows UI的网页
PHP
1
star
28

chainbase-client-go

[WIP]
Go
1
star
29

laravel-7-kubernetes-demo

PHP
1
star
30

go-restful

Go
1
star
31

editor-skill-guide

1
star