包简介

现代化的 PHP 工具包，包含强大的 DOM 操作库、数据转换和一些常用的类库、HTTP网络请求、代码压缩、通用函数集和实用工具等

README 文档

README

基于 PHP 8.2+ 的现代化工具库，严格类型检查，丰富的实用类和函数。

📦 安装

composer require zxf/utils

配置

# Laravel 中发布配置文件
php artisan vendor:publish --tag=utils-config

核心特性

PHP 8.2+ 严格类型：所有文件均启用 declare(strict_types=1)
现代化语法：充分利用 match、联合类型、readonly 类、never 返回类型等
零全局副作用：无隐式时区设置、无意外输出
丰富的辅助函数：50+ 全局便捷函数

常用函数

// 极速并发 UUID 生成器
uuid(): string

// 数据获取与设置
u_data_get($target, 'user.name', 'default');
u_data_set($array, 'user.name', 'John');

// 条件执行
u_when($value, fn ($v) => $v * 2);
u_unless($value, fn () => 'empty');

// 结果封装
$result = u_ok($data);   // Result::ok()
$result = u_err('Error'); // Result::err()

// 性能测试
u_benchmark(fn () => heavyOperation());

// 重试机制
u_retry(fn () => fetchData(), times: 3, sleep: 100);

// 速率限制
u_limiter('api', 60, 60)->attempt();

// 数据大小格式化
u_format_size(1536); // "1.5 KB"
u_parse_size('2.5GB'); // 2684354560

新增工具类

类	说明
`Support\Pipeline`	数据流水线处理，支持异常捕获、条件执行
`Support\Result`	成功/失败结果封装，链式操作
`Support\Retry`	重试机制，支持指数退避、抖动策略
`Support\Benchmark`	性能基准测试，支持多次平均和对比
`Support\Once`	确保回调只执行一次
`Support\Fluent`	流式接口构建器基类
`Support\EnumHelper`	枚举工具类（names/values/random/options）
`Support\RateLimiter`	内存速率限制器
`Support\Condition`	声明式条件执行构建器
`Support\Defer`	Go 风格延迟执行（LIFO）
`Support\Sanitizer`	输入数据清理与规范化
`Net\Url`	URL 解析与链式构建
`Net\Domain`	域名验证、Punycode、DNS/WHOIS 查询
`Convert\DataSize`	数据大小转换（B/KB/MB/GB/TB/PB）
`Convert\Number`	数字格式化、中文大写、缩写、序数
`Convert\Color`	颜色空间转换（HEX/RGB/HSL/HSV/CMYK）
`Convert\Unit`	单位换算工具
`Security\XssCleaner`	XSS 清理工具
`Security\Password`	密码哈希、强度检测、安全生成、HIBP 检测
`Security\Hash`	通用哈希工具（MD5/SHA/HMAC/文件哈希/CRC32）
`Support\Arr`	静态数组工具（点符号路径、扁平化、分组、笛卡尔积）
`Convert\Json`	JSON 编码解码、路径查询、合并、文件读写
`Files\CSV`	CSV 读写、流式处理、编码转换、JSON 互转
`Text\Template`	轻量级模板引擎（变量、条件、循环、过滤器）
`Date\CronExpression`	Cron 表达式解析与下次执行时间计算
`Cache\MemoryCache`	带 TTL 和标签的内存缓存，支持 remember 和原子递增
`Files\Path`	跨平台路径处理（拼接、规范化、相对路径、扩展名）
`Data\Random`	安全随机数据生成（密码、UUID v4、颜色、假数据）
`Security\Token`	HMAC 签名 Token 生成与验证（类似简化版 JWT）
`Support\Timer`	纳秒级计时器与超时控制，支持高精度睡眠
`Text\Diff`	文本差异比较（LCS 算法），支持统一差异和 HTML 高亮
`Files\Archive`	ZIP 压缩解压，支持链式 API、密码保护和目录递归
`Support\Locker`	基于 flock 的进程级互斥锁，支持超时和同步回调
`Support\Event`	轻量级事件分发器，支持通配符和一次性监听器
`Data\Version`	语义化版本号（SemVer）解析、比较和约束匹配

现有模块

Image 图片处理

Http 网络请求

Crypto 加密解密

Data 数据转换、Tree 树形结构、大数计算

Date 日期时间工具

Validate 数据验证

Array 增强数组操作

Str 字符串处理

zxf/utils 适用场景与选型建议

zxf/utils 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 27 次下载、GitHub Stars 达 1，最近一次更新时间为 2025 年 11 月 28 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「php」「curl」「xml」「tree」「image」「file」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 zxf/utils 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 zxf/utils 我们能提供哪些服务？

定制开发 / 二次开发

基于 zxf/utils 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 zxf/utils 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

demvsystems/curl 0

cURL and cURL based Soap-Client for PHP

codezero/curl 0

Simple cURL wrapper

vaclavvanik/dom-loader 1

Load DOM document safety

jmarcher/fluent-curl-wrapper 0

A fluent PHP CURL wrapper

tartan/laravel-xml-response 5

Added a method to Laravel response for handling xml response and also converting Eloquent return to XML.

robgridley/simple-xml-mapper 7

Uses reflection to map XML to PHP objects.

zxf/utils

包简介

关键字：