数据中心同步

2026-01-05 10:16:20 +08:00
parent 0457528dd0
commit ba0ebcf273
98 changed files with 28583 additions and 0 deletions
--- a/Moncter/app/utils/IdCardHelper.php
+++ b/Moncter/app/utils/IdCardHelper.php
@@ -0,0 +1,102 @@
+<?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),
+        ];
+    }
+}
+