一个零碎但实用的 PHP 工具函数集合库。
🌱 很多实现原理都不复杂，但总在项目里反复写，写多了心态有点崩。 干脆集中起来，不重复造轮子，省心省力。
composer require hejunjie/utils这是一个典型的「开发者懒癌工具库」。
在日常项目中，你可能也经常遇到这些情况：
一个数组操作写了无数次；
文件大小格式化总要搜 StackOverflow；
想判断字符串是不是 JSON、是不是手机号、是不是邮箱，结果各种复制粘贴；
项目变了，原来的工具类又得重新封装一遍...
所以，我把这些经常用、常见又简单的小方法统一整理了一下，写成这个工具库。不求高级，不追花哨，目标就是：简单易用，解放双手。
| 方法 | 说明 |
|---|---|
| Str::containsAny() | 检查字符串中是否存在数组中的内容 |
| Str::padString() | 补充特定字符串，使其达到指定长度 |
| Str::replaceFirst() | 替换字符串中第一次出现的搜索值 |
| Str::generateRandomString() | 生成随机字符串 |
| Str::getRandomSurname() | 获取随机姓氏 |
| Str::truncateString() | 截断字符串 |
| Str::maskString() | 字符串掩码 |
| Str::removeWhitespace() | 移除字符串中的所有空白字符 |
| Str::stringEncrypt() | 字符串加密(AES-128-CBC) |
| Str::stringDecrypt() | 字符串解密(AES-128-CBC) |
| Str::formatDurationFromSeconds() | 根据秒数转换为可读性时间 |
| 方法 | 说明 |
|---|---|
| Arr::arrayIntersect() | 获取两个数组的交集 |
| Arr::sortByField() | 根据二维数组中的指定字段排序 |
| Arr::removeDuplicatesByField() | 根据二维数组中指定字段去重 |
| Arr::groupByField() | 根据二维数组中的指定字段进行分组 |
| Arr::csvToArray() | 读取 CSV 文件并返回数组格式 |
| Arr::arrayToCsv() | 数组转换为 CSV 格式的字符串 |
| Arr::xmlParse() | xml解析为数组 |
| Arr::arrayToXml() | 数组转换为xml |
| 方法 | 说明 |
|---|---|
| FileUtils::readFile() | 读取文件内容 |
| FileUtils::writeToFile() | 将内容写入文件 |
| FileUtils::getFileExtension() | 获取文件扩展名 |
| FileUtils::joinPaths() | 拼接多个路径 |
| FileUtils::getFileNameWithoutExtension() | 获取文件名（不带扩展名） |
| FileUtils::fileDelete() | 删除文件或目录 |
| FileUtils::writeUniqueLinesToFile() | 获取文件中的唯一行（去重） |
| FileUtils::getCommonLinesFromFiles() | 从多个文件中获取交集行 |
| FileUtils::extractColumnFromCsvFiles() | 从多个csv文件中快速提取列 |
| 方法 | 说明 |
|---|---|
| HttpClient::sendGetRequest() | 使用 cURL 发送 GET 请求 |
| HttpClient::sendPostRequest() | 使用 cURL 发送 POST 请求 |
| 方法 | 说明 |
|---|---|
| Img::downloadImageFromUrl() | 从 URL 下载图片 |
| Img::imageToBase64() | 将图片转换为 Base64 字符串 |
| Img::base64ToImage() | 将 Base64 字符串保存为图片 |
| Img::compressImage() | 压缩图片到指定大小（单位 KB），支持多种格式转换为 JPEG |
| Img::resizeImage() | 调整图片分辨率，保持宽高比 |
本项目最初是从 hejunjie/tools 拆分而来，如果你想一次性安装所有功能组件，也可以使用统一包：
composer require hejunjie/tools当然你也可以按需选择安装以下功能模块：
hejunjie/cache - 多层缓存系统，基于装饰器模式。
hejunjie/china-division - 中国省市区划分数据包。
hejunjie/error-log - 责任链日志上报系统。
hejunjie/mobile-locator - 国内手机号归属地 & 运营商识别。
hejunjie/address-parser - 收货地址智能解析工具，支持从非结构化文本中提取用户/地址信息。
👀 所有包都遵循「轻量实用、解放双手」的原则，能单独用，也能组合用，自由度高，欢迎 star 🌟 或提 issue。
该库后续将持续更新，添加更多实用功能。欢迎大家提供建议和反馈，我会根据大家的意见实现新的功能，共同提升开发效率。