Identity Card Of China(PHP)獲取身份證信息組件

Identity Card Of China (PHP)是一個(gè)基于「公民身份號(hào)碼」規(guī)則獲取公民身份號(hào)碼中包含的基礎(chǔ)信息組件。

安裝

• 你的 PHP 版本應(yīng)該 >= 7.0

我們使用 Composer 安裝：

composer require medz/id-card-of-china

使用

遵循 PHP-MD 原則，這個(gè)工具不提供靜態(tài)調(diào)用，所以使用需要進(jìn)行對象實(shí)例化：

use Medz\IdentityCard\China\Identity;

$peopleIDNumber = '350301198906180060';
$peopleIdentity = new Identity($peopleIDNumber);

APIs

基于 Medz\IdentityCard\China\IdentityInterface 實(shí)例

• legal：檢查公民身份號(hào)碼是否合法

• birthday：獲取公民身份號(hào)碼中包含的生日信息

• gender：獲取身份證包含的性別信息

• region: 獲取身份證包含的地區(qū)信息，返回 Medz\IdentityCard\China\Region\RegionInterface 實(shí)例

region 對象 APIs

• code： 獲取 GB/T 2260 的地區(qū)行政代碼

• province：獲取省份名稱或者直轄市名稱

• city：獲取城市名稱，如果是直轄市則返回 ''

• county：獲取區(qū)縣名稱

• tree：獲取地區(qū)層級數(shù)組

• treeString：獲取地區(qū)完整字符串，支持傳遞一個(gè)參數(shù)作為省市區(qū)的分隔符

演示

use Medz\IdentityCard\China\Identity;

$peopleIDNumber = '350302198906180060';
$peopleIdentity = new Identity($peopleIDNumber);
$peopleRegion = $peopleIdentity->region();

var_dump(
    $peopleIdentity->legal(),    // true | false
    $peopleIdentity->birthday(), // 1989-06-18
    $peopleIdentity->gender(),   // 女 | 男
    $peopleRegion->code(),       // 350302
    $peopleRegion->province(),   // 福建省
    $peopleRegion->city(),       // 莆田市
    $peopleRegion->county(),     // 城廂區(qū)
    $peopleRegion->tree(),       // ["福建省", "莆田市", "城廂區(qū)"]
    $peopleRegion->treeString(' ') // 福建省 莆田市 城廂區(qū)
);