refactor(core): 放宽 PHP 版本并优化代码逻辑

箭头函数改用闭包函数，部分返回增加空合并运算符兜底

Closes #2

Author: zxc7563598

.gitignore

@@ -1,2 +1,3 @@
 /vendor/
-composer.lock
+composer.lock
+/test.php

composer.json

@@ -15,7 +15,8 @@
     }
   ],
   "require": {
-    "php": ">=8.1",
+    "php": ">=7.0",
+    "ext-mbstring": "*",
     "hejunjie/china-division": "^1.0"
   }
 }

src/AddressParser.php

@@ -10,7 +10,7 @@ class AddressParser
 
     /**
      * 解析地址
-     * @param mixed $string 地址信息
+     * @param string $string 地址信息
      * @param bool $user 信息中是否包含用户信息
      * @param string $unknownValue 未匹配到数据时填充内容
      * @param array $level1Data 一级行政区（省）数据（不传递则使用默认数据源）
@@ -39,23 +39,23 @@ public static function parse(string $string, bool $user = true, $unknownValue =
         ];
         // 提取用户信息（如果需要）
         if ($user) {
-            $extractUserInfo = UserInfoExtractor::extractUserInfo($string);
+            $extractUserInfo = (array)UserInfoExtractor::extractUserInfo($string);
             $data = array_merge($data, [
-                'name' => $extractUserInfo['name'],
-                'mobile' => $extractUserInfo['mobile'],
-                'idn' => $extractUserInfo['idn'],
-                'postcode' => $extractUserInfo['postcode']
+                'name' => $extractUserInfo['name'] ?? '',
+                'mobile' => $extractUserInfo['mobile'] ?? '',
+                'idn' => $extractUserInfo['idn'] ?? '',
+                'postcode' => $extractUserInfo['postcode'] ?? ''
             ]);
-            $addr = $extractUserInfo['addr'];
+            $addr = $extractUserInfo['addr'] ?? '';
         } else {
             $addr = $string;
         }
         // 解析地址
-        $address = RegionMatcher::parseAddress($addr, $unknownValue, $level1Data, $level2Data, $level3Data);
+        $address = (array)RegionMatcher::parseAddress($addr, $unknownValue, $level1Data, $level2Data, $level3Data);
         // 更新地址信息
-        $data['province'] = $address['province'];
-        $data['city'] = $address['city'];
-        $data['region'] = $address['region'];
+        $data['province'] = $address['province'] ?? '';
+        $data['city'] = $address['city'] ?? '';
+        $data['region'] = $address['region'] ?? '';
         $data['street'] = trim(str_replace(
             [$data['region'], $data['city'], $data['province']],
             ['', '', ''],

src/Support/RegionMatcher.php

@@ -145,7 +145,9 @@ public static function parseParsedAddress(
         if ($regionInput === '') {
             return $result;
         }
-        $regionMatches = array_filter($level3Data, fn($v) => mb_strpos($v['name'], $regionInput) !== false);
+        $regionMatches = array_filter($level3Data, function ($v) use ($regionInput) {
+            return mb_strpos($v['name'], $regionInput) !== false;
+        });
         if (count($regionMatches) > 1) {
             $result = self::handleMultipleRegionMatches($regionMatches, $cityInput, $unknownValue, $level1Data, $level2Data, $regionInput);
         } elseif (count($regionMatches) === 1) {
@@ -179,7 +181,9 @@ private static function handleMultipleRegionMatches(array $regionMatches, string
             'city' => $unknownValue,
             'region' => $unknownValue
         ];
-        $cityMatches = array_filter($level2Data, fn($v) => mb_strpos($v['name'], $cityInput) !== false);
+        $cityMatches = array_filter($level2Data, function ($v) use ($cityInput) {
+            return mb_strpos($v['name'], $cityInput) !== false;
+        });
         if (count($cityMatches) > 1) {
             foreach ($regionMatches as $regionMatch) {
                 foreach ($cityMatches as $id => $city) {
@@ -206,7 +210,10 @@ private static function handleMultipleRegionMatches(array $regionMatches, string
             }
         }
         if (count($cityMatches) === 0) {
-            $provinceMatches = array_filter($level1Data, fn($v) => mb_strpos($v['name'], $cityInput) !== false);
+            $provinceMatches = array_filter($level1Data, function ($v) use ($cityInput) {
+                return mb_strpos($v['name'], $cityInput) !== false;
+            });
+
             if (count($provinceMatches) > 1) {
                 foreach ($regionMatches as $regionMatch) {
                     $pidPrefix = substr($regionMatch['pid'], 0, 2);
@@ -295,7 +302,9 @@ private static function handleSingleRegionMatch(array $region, string $unknownVa
      */
     private static function handleNoRegionMatch(string $cityInput, string $regionInput, string $unknownValue, array $level1Data, array $level2Data): array
     {
-        $cityMatches = array_filter($level2Data, fn($v) => mb_strpos($v['name'], $cityInput) !== false);
+        $cityMatches = array_filter($level2Data, function ($v) use ($cityInput) {
+            return mb_strpos($v['name'], $cityInput) !== false;
+        });
 
         if (count($cityMatches) > 0) {
             $first = array_values($cityMatches)[0];
@@ -305,20 +314,21 @@ private static function handleNoRegionMatch(string $cityInput, string $regionInp
                 'region' => $regionInput
             ];
         }
-
-        $provinceMatches = array_filter($level1Data, fn($v) => mb_strpos($v['name'], $cityInput) !== false);
-
+        $provinceMatches = array_filter($level1Data, function ($v) use ($cityInput) {
+            return mb_strpos($v['name'], $cityInput) !== false;
+        });
         if (count($provinceMatches) > 0) {
             foreach ($provinceMatches as $id => $province) {
-                $citiesUnderProvince = array_filter($level2Data, fn($v) => $v['pid'] == $id);
+                $citiesUnderProvince = array_filter($level2Data, function ($v) use ($id) {
+                    return $v['pid'] == $id;
+                });
                 return [
                     'province' => $province['name'],
                     'city' => count($citiesUnderProvince) === 0 ? '' : $unknownValue,
                     'region' => $regionInput
                 ];
             }
         }
-
         return [
             'province' => $unknownValue,
             'city' => $cityInput,