103 lines
3.1 KiB
PHP
103 lines
3.1 KiB
PHP
|
<?php
|
|||
|
|
|
|||
|
|
namespace app\utils;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 身份证工具类
|
|||
|
|
*
|
|||
|
|
* 职责：
|
|||
|
|
* - 从身份证号中提取出生日期
|
|||
|
|
* - 从身份证号中提取性别
|
|||
|
|
* - 验证身份证号格式
|
|||
|
|
*/
|
|||
|
|
class IdCardHelper
|
|||
|
|
{
|
|||
|
|
/**
|
|||
|
|
* 从身份证号中提取出生日期
|
|||
|
|
*
|
|||
|
|
* @param string $idCard 身份证号（15位或18位）
|
|||
|
|
* @return \DateTimeImmutable|null 出生日期，解析失败返回null
|
|||
|
|
*/
|
|||
|
|
public static function extractBirthday(string $idCard): ?\DateTimeImmutable
|
|||
|
|
{
|
|||
|
|
$idCard = trim($idCard);
|
|||
|
|
$length = strlen($idCard);
|
|||
|
|
|
|||
|
|
if ($length === 18) {
|
|||
|
|
// 18位身份证：第7-14位是出生日期（YYYYMMDD）
|
|||
|
|
$birthDateStr = substr($idCard, 6, 8);
|
|||
|
|
$year = (int)substr($birthDateStr, 0, 4);
|
|||
|
|
$month = (int)substr($birthDateStr, 4, 2);
|
|||
|
|
$day = (int)substr($birthDateStr, 6, 2);
|
|||
|
|
} elseif ($length === 15) {
|
|||
|
|
// 15位身份证：第7-12位是出生日期（YYMMDD）
|
|||
|
|
$birthDateStr = substr($idCard, 6, 6);
|
|||
|
|
$year = (int)substr($birthDateStr, 0, 2);
|
|||
|
|
$month = (int)substr($birthDateStr, 2, 2);
|
|||
|
|
$day = (int)substr($birthDateStr, 4, 2);
|
|||
|
|
|
|||
|
|
// 15位身份证的年份需要加上1900或2000
|
|||
|
|
// 通常出生年份在1900-2000之间，如果大于当前年份的后两位，则加1900，否则加2000
|
|||
|
|
$currentYearLastTwo = (int)date('y');
|
|||
|
|
if ($year > $currentYearLastTwo) {
|
|||
|
|
$year += 1900;
|
|||
|
|
} else {
|
|||
|
|
$year += 2000;
|
|||
|
|
}
|
|||
|
|
} else {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 验证日期是否有效
|
|||
|
|
if (!checkdate($month, $day, $year)) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
try {
|
|||
|
|
return new \DateTimeImmutable(sprintf('%04d-%02d-%02d', $year, $month, $day));
|
|||
|
|
} catch (\Throwable $e) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 从身份证号中提取性别
|
|||
|
|
*
|
|||
|
|
* @param string $idCard 身份证号（15位或18位）
|
|||
|
|
* @return int 性别：1=男，2=女，0=未知
|
|||
|
|
*/
|
|||
|
|
public static function extractGender(string $idCard): int
|
|||
|
|
{
|
|||
|
|
$idCard = trim($idCard);
|
|||
|
|
$length = strlen($idCard);
|
|||
|
|
|
|||
|
|
if ($length === 18) {
|
|||
|
|
// 18位身份证：第17位（索引16）是性别码
|
|||
|
|
$genderCode = (int)substr($idCard, 16, 1);
|
|||
|
|
} elseif ($length === 15) {
|
|||
|
|
// 15位身份证：第15位（索引14）是性别码
|
|||
|
|
$genderCode = (int)substr($idCard, 14, 1);
|
|||
|
|
} else {
|
|||
|
|
return 0; // 未知
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 奇数表示男性，偶数表示女性
|
|||
|
|
return ($genderCode % 2 === 1) ? 1 : 2;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 从身份证号中提取所有可解析的信息
|
|||
|
|
*
|
|||
|
|
* @param string $idCard 身份证号
|
|||
|
|
* @return array<string, mixed> 包含 birthday 和 gender 的数组
|
|||
|
|
*/
|
|||
|
|
public static function extractInfo(string $idCard): array
|
|||
|
|
{
|
|||
|
|
return [
|
|||
|
|
'birthday' => self::extractBirthday($idCard),
|
|||
|
|
'gender' => self::extractGender($idCard),
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|