README

生成和验证中国居民身份证号码

安装

通过在composer.json中配置安装：

composer require archerzdip/laravel-identity:dev-master

或

// composer.json
"archerzdip/laravel-identity":"dev-master"
// composer update
composer update

发布

在项目中运行php artisan vendor:publish --provider="ArcherZdip\Identity\IdentityServiceProvice"，将发布此包的所有文件。

使用方法

可以使用identity()帮助函数，或者app('identity_faker')来获取身份证号码

// Get one id number value
identity();

app('identity_faker')->one();

// Get multiple id number value
identity(10);

app('identity_faker')->limit(10)->get();

// 可以设置省份、性别、生日来获取特定身份证号码
app('identity_faker')->province('北京市')->sex('男')->birth('2018-02-09')->one();

可以使用identity_verity()来验证身份号码的有效性

$bool = identity_verity(123456);  // false
// or
use ArcherZdip\Identity\VerityChineseIDNumber;

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

其他功能：

use ArcherZdip\Identity\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()

控制台

可以使用控制台获取一个或多个ID：

$ php artisan identity:get --help                   
Usage:
  identity:get [options]

Options:
  -l, --limit[=LIMIT]        Get identity number
  -P, --province[=PROVINCE]  Set province,like `北京市`
  -S, --sex[=SEX]            Set Sex,like `男`
  -B, --birth[=BIRTH]        Set birth,like xxxx-xx-xx

可以使用-l指定获取数量，-P指定省份，-S指定性别，-B指定生日

也可以使用控制台验证ID是否有效：

$ php artisan identity:verity --help            
Usage:
  identity:verity <idnumber>

Arguments:
  idnumber              Chinese ID number string

后续

身份证号码中包含附加信息，如地区信息、生日、性别等。