README

一个由个人维护的 PHP 原生工具类集合，适用于日常开发中常见需求，支持 Composer 加载。主要功能涵盖字符串处理、数组操作、表单验证、网络请求、文件处理、时间函数等，提升日常开发效率。

📦 安装方式（使用 GitHub 仓库）

composer require hao1617/utils

📚 工具类功能说明

🔠 StrHelper - 字符串处理

• 判断前缀/后缀：startsWith(), endsWith()
• 随机字符串/UUID：random(), uuid()
• 雪花 ID 生成：snowflakeId()

🌐 HttpHelper - 网络请求

• 发起 GET/POST 请求（基于 cURL）
• 获取客户端 IP、判断是否 HTTPS、是否 AJAX 请求等

🐞 DebugHelper - 调试辅助

• dd()：终止并打印
• dump()：输出内容
• json()：JSON 编码输出
• log()：写入日志文件

📦 ArrayHelper - 数组处理

• 获取指定键路径：get($array, 'a.b.c')
• 设置嵌套值：set($array, 'a.b.c', $value)
• 扁平化、多维转一维等处理

📆 DateHelper - 日期时间处理

• 当前时间、时间戳格式化
• 判断是否为今天、本周、本月
• 计算时间差、剩余时间等

📁 FileHelper - 文件处理

• 判断扩展名、大小是否合法
• 保存 base64 图片为文件
• 上传文件保存、生成随机文件名
• 获取 MIME 类型等

✅ ValidatorHelper - 表单验证

• 支持规则：
  • required
  • string
  • numeric
  • string_or_numeric
  • min:x
  • max:x
  • in:a,b,c
  • email 等
• 可扩展自定义验证器
• 返回结构清晰的验证结果

📡 ResponseHelper - 返回结构封装

• 统一结构返回 JSON：

ResponseHelper::success($data, '操作成功');
ResponseHelper::error('参数错误', 400);

• 返回格式：

{
  "code": 0,
  "message": "操作成功",
  "data": {...}
}

🧩 使用示例

use Gongying\Utils\StrHelper;
use Gongying\Utils\ResponseHelper;

$id = StrHelper::uuid();
return ResponseHelper::success(['id' => $id]);

🔧 要求

• PHP >= 7.2
• 推荐搭配框架：ThinkPHP、Laravel、Symfony 等

📬 作者信息

• Author: Hao1617
• Email: lic652149@gmail.com

📝 License

MIT License