PHPackages                             archerzdip/chinese-idnumber-generate - 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 &amp; Helpers](/categories/utility)
4. /
5. archerzdip/chinese-idnumber-generate

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

archerzdip/chinese-idnumber-generate
====================================

Chinses ID number generate package.

26PHP

Since May 22Pushed 6y agoCompare

[ Source](https://github.com/ArcherZdip/chinese-idnumber-generate)[ Packagist](https://packagist.org/packages/archerzdip/chinese-idnumber-generate)[ RSS](/packages/archerzdip-chinese-idnumber-generate/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Generate Chinese ID Number
==========================

[](#generate-chinese-id-number)

The project has been refactored, and the new address is

Installation
------------

[](#installation)

### composer

[](#composer)

```
composer require archerzdip/chinese-idnumber-generate

```

### Laravel

[](#laravel)

In your config/app.php add ArcherZdip\\GenerateIDNumber\\GenerateChineseIDNumberServiceProvider::class, to the end of the providers array:

```
'providers' => [
    ...
    ArcherZdip\GenerateIDNumber\GenerateChineseIDNumberServiceProvider::class,
],
```

If you're using Laravel 5.5, this is all there is to do.

Methods
-------

[](#methods)

- get()
- getone()
- on(array $attributes)
- limit(int $count)
- toString()
- toArray()
- province(string $province)
- city(string $city)
- region(string $region)
- sex(int $sex)
- datetime(string $datetime)

Usage
-----

[](#usage)

### **getOne() usage:**

[](#getone-usage)

```
$idNo = app('chinese_id_faker')->on([
    'province' => '辽宁省',
    'city'    => '', // random
    'region'    => '', // random
    'datetime' => '', // random
    'sex'      => 0,  // 0-male  1-female
])->getOne();
dd($idNo);
```

**Result is object:**

```
ArcherZdip\GenerateIDNumber\ChineseIDNumber {#266
  +id: "210422201802123855"
  +province: "辽宁省"
  +city: "抚顺市"
  +region: "新宾满族自治县"
  +sex: "男"
  +birth: "20180212"
}

```

### **get() usage"**

[](#get-usage)

```
$idNos = app('chinese_id_faker')->on([
    'province' => '辽宁省',
    'city'    => '',
    'region'    => '',
    'datetime' => '',
    'sex'      => 1,  // 0-male  1-female
])->limit(1)->get();
dd($idNos);
```

**Result is object:**

```
ArcherZdip\GenerateIDNumber\Foo {#267
  +items: array:1 [
    0 => ArcherZdip\GenerateIDNumber\ChineseIDNumber {#266
      +id: "511825197911085740"
      +province: "四川省"
      +city: "雅安市"
      +region: "天全县"
      +sex: "女"
      +birth: "19791108"
    }
  ]
}

```

### **On(array $attributes) usage:**

[](#onarray-attributes-usage)

$attributes is arguments,including:

- province: Chinese province
- city: city, like `沈阳市`
- region: region, like `某某区`
- datetime: Birthdate, format is 2018-08-08
- sex: Sex, 0 is male and 1 is female

### **limit(int $count) usage:**

[](#limitint-count-usage)

Limit the number of rows you can get.

### **toString() usage:**

[](#tostring-usage)

Just show chinese id number.

```
"211201201802129542"

```

or:

```
array:2 [
  0 => "63212619971109033X"
  1 => "810000195308134165"
]

```

### **toArray() usage:**

[](#toarray-usage)

Object to array. Like:

```
array:6 [
  "id" => "211201201802129542"
  "province" => "辽宁省"
  "city" => "铁岭市"
  "region" => "市辖区"
  "sex" => "女"
  "birth" => "20180212"
]

```

### **province(string $province) usage:**

[](#provincestring-province-usage)

Set province.

### **city(string $city) usage:**

[](#citystring-city-usage)

Set city.

### **region(string $region) usage:**

[](#regionstring-region-usage)

Set region.

### **sex(int $sex) usage:**

[](#sexint-sex-usage)

Set sex.

### **datetime(string $datetime) usage:**

[](#datetimestring-datetime-usage)

Set datetime, format xxxx-xx-xx.

Other Function
--------------

[](#other-function)

VerityChineseIDNumber can verity chinese id number.
**Usage:**

```
use ArcherZdip\GenerateIDNumber\VerityChineseIDNumber;

$bool = VerityChineseIDNumber::isValid(string $idNumber);
```

**Other methods:**

```
use ArcherZdip\GenerateIDNumber\VerityChineseIDNumber;

// 获取生日
$birthday = (new VerityChinsesIDNumber(string $idNumber))->getBirthday()->format('Y-m-d');

// 获取年龄
$age = (new VerityChinsesIDNumber(string $idNumber))->getAge();

// 是否为男性
$isMale = (new VerityChinsesIDNumber(string $idNumber))->isMale();

// 是否为女性
$isFemale = (new VerityChinsesIDNumber(string $idNumber))->isFemale();

// 获取年份
$year = (new VerityChinsesIDNumber(string $idNumber))->getYear()

// 获取月份
$month = (new VerityChinsesIDNumber(string $idNumber))->getmonth()

// 获取日期
$day = (new VerityChinsesIDNumber(string $idNumber))->getday()
```

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/25f63f83fcd43e4ae6cf9243d2cb7613b793962e221cffb8073b6d8f5f3b3b93?d=identicon)[ArcherZdip](/maintainers/ArcherZdip)

---

Top Contributors

[![ArcherZdip](https://avatars.githubusercontent.com/u/37647592?v=4)](https://github.com/ArcherZdip "ArcherZdip (1 commits)")

### Embed Badge

![Health badge](/badges/archerzdip-chinese-idnumber-generate/health.svg)

```
[![Health](https://phpackages.com/badges/archerzdip-chinese-idnumber-generate/health.svg)](https://phpackages.com/packages/archerzdip-chinese-idnumber-generate)
```

###  Alternatives

[hillholliday/craft-user-manual

Craft User Manual allows developers (or even content editors) to provide CMS documentation using Craft's built-in sections (singles, channels, or structures) to create a `User Manual` or `Help` section directly in the control panel.

8472.1k1](/packages/hillholliday-craft-user-manual)

PHPackages © 2026

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