PHPackages                             vvk/id-card - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. vvk/id-card

ActiveLibrary[Utility & Helpers](/categories/utility)

vvk/id-card
===========

一个用于身份证号归属地查询、身份证号生成、15位身份证号转18位身份证号的包

v1.0.2(1y ago)3371MITPHPPHP ~7.0

Since Oct 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/vvk/id-card)[ Packagist](https://packagist.org/packages/vvk/id-card)[ RSS](/packages/vvk-id-card/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

身份证号码归属地查询、身份证号码生成、15位身份证号转18位
==============================

[](#身份证号码归属地查询身份证号码生成15位身份证号转18位)

**注：** 本代码仅供学习交流使用，请勿用于商业或其他违法行为，否则后果自负。

说明
--

[](#说明)

- 数据来源为 [国家统计局](http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2019/index.html)，最新更新于2019年10月31日。
- 仅支持中国大陆的身份证号

功能
--

[](#功能)

- 身份证号归属地查询，包括省、城市、区/县
- 根据省、市、区/县及出生日期生成身份证号
- 15位短身份证号码生成18位身份证证号码

安装
--

[](#安装)

使用 composer 安装：

```
composer require vvk/id-card
```

使用
--

[](#使用)

### 身份证号码归属地查询

[](#身份证号码归属地查询)

```
include "vendor/autoload.php";
use Vvk\IdCard\IdCard;

$idCard = '110101192009309116';
$location = IdCard::parse($idCard);//支持15位、18位身份证号
print_r($location);
/*
结果：
Array
(
    [province] => 北京市
    [city] => 北京市
    [district] => 东城区
    [area] => 北京市 北京市 东城区
    [date] => 1920-09-30
    [sex] => 男
    [constellation] => 天秤座
)
*/
```

### 身份证号码生成

[](#身份证号码生成)

```
include "vendor/autoload.php";
use Vvk\IdCard\IdCard;

//通过 IdCard::getLocation() 获取到的对应的区、县code
//广东东莞市、广东中山市、海南儋州三个城市下面没有区、县，只在在对应的城市后面补助 00 组成6位字符串即可
$location = '110101';

// 日期格式为 YYYmmdd
$date = '20201003';
$result = IdCard::generate($location, $date, 1);
echo $result.PHP_EOL;
/**
结果：
110101202010035331
*/
```

### 15位身份证号码转18位

[](#15位身份证号码转18位)

```
include "vendor/autoload.php";
use Vvk\IdCard\IdCard;

$idCard = '320506720102256';
$result = IdCard::getLongIdCard($idCard);
echo $result.PHP_EOL;
/*
结果：
320506197201022567
*/
```

### 数据更新

[](#数据更新)

身份证号前6位为归属地，可以从 [国家统计局](http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2019/index.html) 获取，由于数据可能会变化（感觉机率比较小，毕竟身份证号不会变化 ），会造成身份证号识别不准确的情况，所以数据需要定时更新，可以通过下面的方式更新：

```
include "vendor/autoload.php";
use Vvk\IdCard\UpdateLocation;

UpdateLocation::run();
```

### 说明

[](#说明-1)

- 如果结果返回空，可以使用方法 `IdCard::getError()` 获取失败原因。
- 广东东莞市、广东中山市、海南儋州市三个城市下面不再区分区、县，即前6位整个城市相同。

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance46

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~845 days

Total

3

Last Release

407d ago

PHP version history (2 changes)v1.0PHP ^7.0

v1.0.2PHP ~7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13550303?v=4)[sunwq](/maintainers/sunwq)[@sunwq](https://github.com/sunwq)

---

Top Contributors

[![vvk](https://avatars.githubusercontent.com/u/8386095?v=4)](https://github.com/vvk "vvk (12 commits)")

---

Tags

idcard-checkidcard-generatorphpvvkvvk15位身份证号转18位

### Embed Badge

![Health badge](/badges/vvk-id-card/health.svg)

```
[![Health](https://phpackages.com/badges/vvk-id-card/health.svg)](https://phpackages.com/packages/vvk-id-card)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k42](/packages/civicrm-civicrm-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[oat-sa/tao-core

TAO core extension

66143.7k121](/packages/oat-sa-tao-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)