介绍

\Swx\IdCard\IdCard组件，用于支持 身份证号码 校验、归属地、性别、出生年月，解析处理。

安装

composer require swx/idcard

环境

运行环境：

• PHP7.0+
• Windows / Linux
• Swoole / FPM

支持的框架：

• SW-X
• 常用的FPM框架，如：ThinkPHP

调用

依赖类：\Swx\IdCard\IdCard
方法名：handle()

参数：

• string $id_card

  • 功能：身份证号码
  • 默认值：无

返回值：false 或 array()

使用示例：

$obj = new \Swx\IdCard\IdCard();
// 返回 false表示解析失败，成功返回array
$obj->handle('正确的身份证号码');

获取解析失败原因

依赖类：\Swx\IdCard\IdCard
方法名：error()

参数：无

返回值：string

使用示例：

$obj = new \Swx\IdCard\IdCard();
$ret = $obj->handle('正确的身份证号码');
if ($ret === false) {
	echo $obj->error();
}

获取解析成功结果

当解析成功时，handle()方法会返回解析结果，是一个一维的array数据结构。

同时，该组件也支持使用访问成员属性的方式，对结果集中的某一个字段值进行获取。

使用示例：

$obj = new \Swx\IdCard\IdCard();
$ret = $obj->handle('正确的身份证号码');
// 打印整个结果集
var_dump($ret);
// 通过访问成员属性的方法，获得单个字段信息
var_dump($obj->city);

解析包含内容

解析结果的数组内容结构如下：