first commit

Author: 苏青安

.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+.DS_Store

composer.json

@@ -0,0 +1,18 @@
+{
+  "name": "hejunjie/utils",
+  "description": "包含文件、字符串、数组、网络请求等常用函数的工具类集合，提升开发效率，适用于日常 PHP 项目辅助功能。",
+  "license": "MIT",
+  "type": "library",
+  "autoload": {
+    "psr-4": {
+      "Hejunjie\\Utils\\": "src/"
+    }
+  },
+  "authors": [
+    {
+      "name": "何俊杰",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {}
+}

src/Arr.php

@@ -0,0 +1,223 @@
+<?php
+
+namespace Hejunjie\Utils;
+
+/**
+ * 数组处理类
+ * 
+ * @package Hejunjie\Utils
+ */
+class Arr
+{
+    /**
+     * 获取两个数组的交集
+     * 
+     * @param array $array1 数组1
+     * @param array $array2 数组2
+     * 
+     * @return array 
+     * @throws Exception
+     */
+    public static function arrayIntersect(array $array1, array $array2): array
+    {
+        // 检查输入的两个参数是否都是数组
+        if (!is_array($array1) || !is_array($array2)) {
+            throw new \Exception('输入的参数必须是数组');
+        }
+        return array_intersect($array1, $array2);
+    }
+
+    /**
+     * 根据二维数组中的指定字段排序
+     * 
+     * @param array $array 二维数组
+     * @param string $field 排序字段
+     * @param bool $ascending 是否按升序排序（默认升序）
+     * 
+     * @return array
+     * @throws Exception
+     */
+    public static function sortByField(array $array, string $field, bool $ascending = true): array
+    {
+        // 检查数组中的每个元素是否为数组，并且包含指定的字段
+        foreach ($array as $item) {
+            if (!is_array($item)) {
+                throw new \Exception('输入的数组中的每个元素必须是关联数组');
+            }
+            if (!array_key_exists($field, $item)) {
+                throw new \Exception("字段 '$field' 不存在于数组中的某些元素中");
+            }
+        }
+        // 使用 usort 对数组进行排序
+        usort($array, function ($a, $b) use ($field, $ascending) {
+            return $ascending ? $a[$field] <=> $b[$field] : $b[$field] <=> $a[$field];
+        });
+        return $array;
+    }
+
+    /**
+     * 根据二维数组中指定字段去重
+     * 
+     * @param array $array 二维数组
+     * @param string $field 指定的去重字段
+     * 
+     * @return array
+     * @throws Exception
+     */
+    public static function removeDuplicatesByField(array $array, string $field): array
+    {
+        // 用于记录字段值的数组
+        $unique = [];
+        // 存储去重后的结果数组
+        $result = [];
+        // 遍历数组，检查并去重
+        foreach ($array as $item) {
+            // 确保每个项目是数组并且包含指定的字段
+            if (!is_array($item)) {
+                throw new \Exception('输入的数组中的每个元素必须是关联数组');
+            }
+            if (!array_key_exists($field, $item)) {
+                throw new \Exception("字段 '$field' 不存在于数组中的某些元素中");
+            }
+            // 如果该字段值不在unique数组中，则添加到结果中
+            if (!in_array($item[$field], $unique, true)) {
+                $unique[] = $item[$field];
+                $result[] = $item;
+            }
+        }
+        return $result;
+    }
+
+    /**
+     * 根据二维数组中的指定字段进行分组
+     * 
+     * @param array $array 二维数组
+     * @param string $field 指定的分组字段
+     * 
+     * @return array
+     * @throws Exception
+     */
+    public static function groupByField(array $array, string $field): array
+    {
+        // 初始化分组数组
+        $grouped = [];
+        // 遍历数组并根据字段进行分组
+        foreach ($array as $item) {
+            // 确保每个项目是数组并且包含指定的字段
+            if (!is_array($item)) {
+                throw new \Exception('输入的数组中的每个元素必须是关联数组');
+            }
+            if (!array_key_exists($field, $item)) {
+                throw new \Exception("字段 '$field' 不存在于数组中的某些元素中");
+            }
+            // 按字段值进行分组
+            $grouped[$item[$field]][] = $item;
+        }
+        return $grouped;
+    }
+
+    /**
+     * 数组转换为 CSV 格式的字符串
+     * 
+     * @param array $array 数组
+     * @param string $delimiter CSV 分隔符，默认为逗号
+     * @param string $enclosure CSV 包裹符号，默认为双引号
+     * @param string $escapeChar 转义符号，默认为反斜杠
+     * 
+     * @return string
+     */
+    public static function arrayToCsv(array $array, string $delimiter = ',', string $enclosure = '"', string $escapeChar = '\\'): string
+    {
+        // 开启输出缓冲区
+        ob_start();
+        // 打开 PHP 输出流
+        $output = fopen('php://output', 'w');
+        // 检查文件句柄是否打开成功
+        if ($output === false) {
+            throw new \Exception('无法打开输出流');
+        }
+        // 遍历数组并写入 CSV 格式
+        foreach ($array as $row) {
+            if (!is_array($row)) {
+                throw new \Exception('输入的每一行都必须是一个数组');
+            }
+            fputcsv($output, $row, $delimiter, $enclosure, $escapeChar);
+        }
+        // 关闭文件句柄
+        fclose($output);
+        // 获取缓冲区内容
+        return ob_get_clean();
+    }
+
+    /**
+     * 解析 XML 数据并返回数组
+     *
+     * @param string $xmlString XML 字符串
+     * 
+     * @return array 解析后的数组
+     * @throws \Exception
+     */
+    public static function xmlParse(string $xmlString): array
+    {
+        // 禁用 libxml 错误和启用异常
+        libxml_use_internal_errors(true);
+        // 加载 XML 字符串
+        $xml = simplexml_load_string($xmlString, "SimpleXMLElement", LIBXML_NOCDATA);
+        // 检查 XML 是否加载成功
+        if ($xml === false) {
+            $errors = libxml_get_errors();
+            libxml_clear_errors();
+            throw new \Exception("XML 解析错误: " . implode(", ", $errors));
+        }
+        // 转换为数组
+        return self::xmlToArray($xml);
+    }
+
+    /**
+     * 递归将 SimpleXMLElement 转换为数组
+     *
+     * @param SimpleXMLElement $xml XML 元素
+     * @return array 转换后的数组
+     */
+    private static function xmlToArray($xml): array
+    {
+        $array = json_decode(json_encode($xml), true);
+        // 处理每个元素
+        foreach ($array as $key => $value) {
+            if (is_array($value)) {
+                // 递归处理子元素
+                $array[$key] = self::xmlToArray($value);
+            }
+        }
+        return $array;
+    }
+
+    /**
+     * 将数组转换为 XML 字符串
+     *
+     * @param array $data 要转换的数组
+     * @param string $rootElement 根元素名称
+     * @param SimpleXMLElement|null $xmlObject 用于递归的 SimpleXMLElement 对象
+     * 
+     * @return string 转换后的 XML 字符串
+     */
+    public static function arrayToXml(array $data, string $rootElement = 'root', \SimpleXMLElement $xmlObject = null): string
+    {
+        // 创建根元素
+        if ($xmlObject === null) {
+            $xmlObject = new \SimpleXMLElement("<{$rootElement}/>");
+        }
+        foreach ($data as $key => $value) {
+            // 处理键名
+            $formattedKey = is_numeric($key) ? "item{$key}" : $key;
+            // 如果值是数组，则递归调用
+            if (is_array($value)) {
+                self::arrayToXml($value, $formattedKey, $xmlObject->addChild($formattedKey));
+            } else {
+                // 添加值到 XML
+                $xmlObject->addChild($formattedKey, htmlspecialchars($value));
+            }
+        }
+        return $xmlObject->asXML();
+    }
+}