refactor(app/utils): 重构 EnumUtil 类

- 优化了枚举验证逻辑，提高了代码可读性和维护性
- 新增 getEnumConstants 和 isValidEnumArray 方法，用于获取枚举常量和验证枚举数组
- 改进了错误处理，使错误信息更加清晰
- 优化了字段映射获取逻辑，提高了代码复用性

app/utils/EnumUtil.php

@@ -3,6 +3,7 @@
 namespace app\utils;
 
 use ReflectionClass;
+use ReflectionException;
 
 /**
  * 智能枚举验证器
@@ -22,53 +23,89 @@ class EnumUtil
         $errors = [];
         
         try {
-            $reflection = new ReflectionClass($enumClassOrInstance);
-            $constants = $reflection->getConstants();
+            $constants = self::getEnumConstants($enumClassOrInstance);
 
             foreach ($constants as $constName => $enumValues) {
-                if (!is_array($enumValues)) {
-                    continue;
-                }
-                
-                // 跳过MAP格式的枚举定义（包含code字段的）
-                if (self::isMapFormat($enumValues)) {
+                if (!self::isValidEnumArray($enumValues)) {
                     continue;
                 }
 
-                // 将枚举常量名转换为可能的请求字段名
                 $fieldName = self::constToFieldName($constName);
 
-                // 检查请求数据中是否存在该字段
                 if (array_key_exists($fieldName, $requestData)) {
-                    $value = $requestData[$fieldName];
-                    $result = self::validateEnumValue($value, $enumValues, $constName);
+                    $result = self::validateEnumValue($requestData[$fieldName], $enumValues, $constName);
                     if (!$result['valid']) {
                         $errors[] = $result['error'];
                     }
                 }
             }
 
-        } catch (\ReflectionException $e) {
+        } catch (ReflectionException $e) {
             return [
                 'valid' => false,
                 'errors' => ["枚举验证异常: " . $e->getMessage()]
             ];
         }
 
-        if (!empty($errors)) {
-            return [
-                'valid' => false,
-                'errors' => $errors
-            ];
-        }
-
-        return [
+        return empty($errors) ? [
             'valid' => true,
             'errors' => []
+        ] : [
+            'valid' => false,
+            'errors' => $errors
         ];
     }
 
     /**
+     * 获取枚举类的所有字段映射
+     *
+     * @param string|object $enumClassOrInstance 枚举类名或实例
+     * @return array 字段映射 [字段名 => 枚举值数组]
+     */
+    public static function getFieldMappings($enumClassOrInstance): array
+    {
+        $mappings = [];
+        
+        try {
+            $constants = self::getEnumConstants($enumClassOrInstance);
+
+            foreach ($constants as $constName => $enumValues) {
+                if (self::isValidEnumArray($enumValues)) {
+                    $mappings[self::constToFieldName($constName)] = $enumValues;
+                }
+            }
+
+        } catch (ReflectionException $e) {
+            // 忽略异常，返回空数组
+        }
+
+        return $mappings;
+    }
+
+    /**
+     * 获取枚举类的常量
+     *
+     * @param string|object $enumClassOrInstance
+     * @return array
+     * @throws ReflectionException
+     */
+    private static function getEnumConstants($enumClassOrInstance): array
+    {
+        return (new ReflectionClass($enumClassOrInstance))->getConstants();
+    }
+
+    /**
+     * 检查是否为有效的枚举数组（非MAP格式的数组）
+     *
+     * @param mixed $enumValues
+     * @return bool
+     */
+    private static function isValidEnumArray($enumValues): bool
+    {
+        return is_array($enumValues) && !empty($enumValues) && !self::isMapFormat($enumValues);
+    }
+
+    /**
      * 将枚举常量名转换为字段名
      *
      * @param string $constName 常量名称
@@ -76,7 +113,6 @@ class EnumUtil
      */
     private static function constToFieldName(string $constName): string
     {
-        // 将下划线命名转换为蛇形命名（小写+下划线）
         return strtolower($constName);
     }
 
@@ -90,24 +126,13 @@ class EnumUtil
      */
     private static function validateEnumValue($value, array $enumValues, string $constName): array
     {
-        if (!is_array($enumValues) || empty($enumValues)) {
-            return [
-                'valid' => false,
-                'error' => '枚举值配置错误'
-            ];
-        }
-
-        // 提取所有有效值（简单格式的键）
         $validValues = array_keys($enumValues);
-
-        // 处理字符串数字和整数的类型转换
         $normalizedValue = is_numeric($value) ? (int)$value : $value;
         
         if (!in_array($normalizedValue, $validValues, true)) {
-            $fieldName = self::constToFieldName($constName);
             return [
                 'valid' => false,
-                'error' => "{$fieldName}参数错误，值：{$value}"
+                'error' => self::constToFieldName($constName) . "参数错误，值：{$value}"
             ];
         }
 
@@ -118,34 +143,6 @@ class EnumUtil
     }
 
     /**
-     * 获取枚举类的所有字段映射
-     *
-     * @param string|object $enumClassOrInstance 枚举类名或实例
-     * @return array 字段映射 [字段名 => 枚举值数组]
-     */
-    public static function getFieldMappings($enumClassOrInstance): array
-    {
-        $mappings = [];
-        
-        try {
-            $reflection = new ReflectionClass($enumClassOrInstance);
-            $constants = $reflection->getConstants();
-
-            foreach ($constants as $constName => $enumValues) {
-                if (is_array($enumValues) && !self::isMapFormat($enumValues)) {
-                    $fieldName = self::constToFieldName($constName);
-                    $mappings[$fieldName] = $enumValues;
-                }
-            }
-
-        } catch (\ReflectionException $e) {
-            // 忽略异常，返回空数组
-        }
-
-        return $mappings;
-    }
-
-    /**
      * 检查枚举值数组是否为MAP格式（包含code字段）
      *
      * @param array $enumValues 枚举值数组
@@ -153,12 +150,10 @@ class EnumUtil
      */
     private static function isMapFormat(array $enumValues): bool
     {
-        // 如果是空数组，跳过
         if (empty($enumValues)) {
             return false;
         }
         
-        // 检查第一个元素是否包含code字段
         $firstValue = reset($enumValues);
         return is_array($firstValue) && isset($firstValue['code']);
     }