功能上线

Author: zxc7563598

.github/workflows/assign-issue.yml

@@ -0,0 +1,15 @@
+name: Assign Issue to Myself
+
+on:
+  issues:
+    types: [opened]  # 只对新开的 issue 触发
+
+jobs:
+  assign:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Assign issue to me
+        uses: peter-evans/assign-issue@v2
+        with:
+          issue-number: ${{ github.event.issue.number }}
+          assignees: 'zxc7563598'

.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+composer.lock

composer.json

@@ -0,0 +1,21 @@
+{
+  "name": "hejunjie/address-parser",
+  "description": "收货地址智能解析工具，支持从非结构化文本中提取姓名、手机号、身份证号、省市区、详细地址等字段，适用于电商、物流、CRM 等系统。",
+  "type": "library",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Hejunjie\\AddressParser\\": "src/"
+    }
+  },
+  "authors": [
+    {
+      "name": "何俊杰",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {
+    "php": ">=8.1",
+    "hejunjie/china-division": "^1.0"
+  }
+}

src/AddressParser.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Hejunjie\AddressParser;
+
+use Hejunjie\AddressParser\Support\RegionMatcher;
+use Hejunjie\AddressParser\Support\UserInfoExtractor;
+
+class AddressParser
+{
+
+    /**
+     * 解析地址
+     * @param mixed $string 地址信息
+     * @param bool $user 信息中是否包含用户信息
+     * 
+     * @return array {name: string, mobile: string, idn: string, postcode: string, province: string, city: string, region: string, street: string} 
+     */
+    public static function parse(string $string, bool $user = true)
+    {
+        // 默认数据
+        $data = [
+            'name' => '',
+            'mobile' => '',
+            'idn' => '',
+            'postcode' => '',
+            'province' => '',
+            'city' => '',
+            'region' => '',
+            'street' => ''
+        ];
+        // 提取用户信息（如果需要）
+        if ($user) {
+            $extractUserInfo = UserInfoExtractor::extractUserInfo($string);
+            $data = array_merge($data, [
+                'name' => $extractUserInfo['name'],
+                'mobile' => $extractUserInfo['mobile'],
+                'idn' => $extractUserInfo['idn'],
+                'postcode' => $extractUserInfo['postcode']
+            ]);
+            $addr = $extractUserInfo['addr'];
+        } else {
+            $addr = $string;
+        }
+        // 解析地址
+        $address = RegionMatcher::parseAddress($addr);
+        // 更新地址信息
+        $data['province'] = $address['province'];
+        $data['city'] = $address['city'];
+        $data['region'] = $address['region'];
+        $data['street'] = trim(str_replace(
+            [$data['region'], $data['city'], $data['province']],
+            ['', '', ''],
+            $address['street'] ?? ''
+        ));
+        // 返回数据
+        return $data;
+    }
+}