PHPackages yuandian/tools - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. yuandian/tools ActiveLibrary[Utility & Helpers](/categories/utility) yuandian/tools ============== A component for tools. v1.7.0(1mo ago)1443MITPHPPHP >=8.1 Since Jul 24Pushed 1mo agoCompare [ Source](https://github.com/yuan-dian/tools)[ Packagist](https://packagist.org/packages/yuandian/tools)[ RSS](/packages/yuandian-tools/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependenciesVersions (11)Used By (3) yuandian/tools ============== [](#yuandiantools) 高性能 PHP 工具包，提供字符串、数组、日期、验证、流式处理等常用功能。 安装 -- [](#安装) ``` composer require yuandian/tools ``` 功能模块 ---- [](#功能模块) 模块方法数说明BeanUtil6实体转换（数组↔对象↔JSON）StrUtil65字符串操作ArrUtil95数组操作DateUtil62日期时间操作ValidatorUtil52数据验证Stream43流式操作CollectionUtil45集合操作RandomUtil18随机数生成ReUtil19正则操作ObjectUtil12对象操作NumberUtil14数字操作MapUtil12Map操作IdUtil6ID生成UUIDUtil3UUID生成SnowflakeUtil2雪花算法DigestUtil5摘要算法CharsetUtil4字符集操作使用示例 ---- [](#使用示例) ### BeanUtil - 实体转换 [](#beanutil---实体转换) ``` use yuandian\Tools\bean\BeanUtil; // 数组转对象 $user = BeanUtil::arrayToObject($userData, User::class); // 对象转数组 $array = BeanUtil::objectToArray($user); // 对象转对象 $vo = BeanUtil::objectToObject($user, UserVO::class); // JSON转对象 $user = BeanUtil::jsonToObject($jsonString, User::class); ``` ### StrUtil - 字符串操作 [](#strutil---字符串操作) ``` use yuandian\Tools\utils\StrUtil; // 判断 StrUtil::isEmpty(''); // true StrUtil::isBlank(' '); // true StrUtil::contains('hello', 'll'); // true StrUtil::startsWith('hello', 'he'); // true StrUtil::endsWith('hello', 'lo'); // true // 转换 StrUtil::snake('helloWorld'); // hello_world StrUtil::camel('hello_world'); // helloWorld StrUtil::studly('hello_world'); // HelloWorld StrUtil::kebab('helloWorld'); // hello-world StrUtil::swapCase('Hello'); // hELLO // 操作 StrUtil::repeat('abc', 3); // abcabcabc StrUtil::reverse('hello'); // olleh StrUtil::remove('hello world', ' world'); // hello StrUtil::replace('hello', 'l', 'r'); // herro StrUtil::abbreviate('这是一段很长的字符串', 6); // 这是一... StrUtil::format('Hello {}', 'World'); // Hello World ``` ### ArrUtil - 数组操作 [](#arrutil---数组操作) ``` use yuandian\Tools\utils\ArrUtil; // 判断 ArrUtil::isEmpty([]); // true ArrUtil::contains([1,2,3], 2); // true // 转换 ArrUtil::flatten([[1,2],[3]]); // [1,2,3] ArrUtil::groupBy($users, 'age'); ArrUtil::keyBy($users, 'id'); ArrUtil::pluck($users, 'name'); // 操作 ArrUtil::take([1,2,3,4,5], 3); // [1,2,3] ArrUtil::drop([1,2,3,4,5], 2); // [3,4,5] ArrUtil::zip([1,2], ['a','b']); // [[1,'a'],[2,'b']] ArrUtil::partition([1,2,3,4], fn($v) => $v%2===0); // 统计 ArrUtil::min([1,2,3]); // 1 ArrUtil::max([1,2,3]); // 3 ArrUtil::sum([1,2,3]); // 6 ArrUtil::frequency(['a','b','a']); // ['a'=>2,'b'=>1] ``` ### DateUtil - 日期操作 [](#dateutil---日期操作) ``` use yuandian\Tools\utils\DateUtil; // 创建 DateUtil::now(); // 当前时间 DateUtil::parse('2024-06-15', 'Y-m-d'); // 解析日期 DateUtil::parseInt(1718409600); // 时间戳转日期 DateUtil::range(1, 10); // 数字范围 // 加减 DateUtil::addDays($date, 5); // 加5天 DateUtil::addHours($date, 2); // 加2小时 DateUtil::addMonths($date, 1); // 加1月 // 比较 DateUtil::isBefore($date1, $date2); // 在之前 DateUtil::isAfter($date1, $date2); // 在之后 DateUtil::isBetween($date, $start, $end); // 在之间 DateUtil::isSameDay($date1, $date2); // 同一天 // 判断 DateUtil::isToday($date); // 今天 DateUtil::isWeekend($date); // 周末 DateUtil::isFuture($date); // 未来 // 格式化 DateUtil::format($date, 'Y-m-d'); // 格式化 DateUtil::formatRelative($date); // 相对时间（3分钟前） DateUtil::formatChinese($date); // 中文格式 // 边界 DateUtil::beginOfDay($date); // 当天开始 DateUtil::endOfDay($date); // 当天结束 DateUtil::beginOfWeek($date); // 本周开始 DateUtil::beginOfMonth($date); // 月初 DateUtil::beginOfYear($date); // 年初 ``` ### ValidatorUtil - 数据验证 [](#validatorutil---数据验证) ``` use yuandian\Tools\utils\ValidatorUtil; // 基础验证 ValidatorUtil::isEmail('test@example.com'); // true ValidatorUtil::isMobile('13800138000'); // true ValidatorUtil::isUrl('https://example.com'); // true ValidatorUtil::isIP('192.168.1.1'); // true ValidatorUtil::isUUID('550e8400-e29b-41d4...'); // true // 中国验证 ValidatorUtil::isIdCard('110101199001011234'); // 身份证 ValidatorUtil::isCarLicense('京A12345'); // 车牌号 ValidatorUtil::isCreditCode('91110105...'); // 统一信用代码 // 类型验证 ValidatorUtil::isInteger('123'); // 整数 ValidatorUtil::isFloat('12.3'); // 浮点数 ValidatorUtil::isJson('{"a":1}'); // JSON ValidatorUtil::isDate('2024-06-15'); // 日期 ValidatorUtil::isHexColor('#ff00ff'); // 十六进制颜色 // 范围验证 ValidatorUtil::isBetween(5, 1, 10); // 在范围内 ValidatorUtil::isLengthBetween('hi', 3, 10); // 长度在范围内 ValidatorUtil::isStrongPassword('Abc123!@'); // 强密码 // 校验抛异常 ValidatorUtil::validateEmail('invalid'); // 抛异常 ValidatorUtil::notEmpty(null); // 抛异常 ``` ### Stream - 流式操作 [](#stream---流式操作) ``` use yuandian\Tools\utils\Stream; // 创建 Stream::of([1, 2, 3, 4, 5]); Stream::range(1, 100); Stream::iterate(1, 1); // 无限流 // 转换 Stream::of($array) ->filter(fn($n) => $n > 2) ->map(fn($n) => $n * 2) ->distinct() ->sorted() ->toArray(); // 截取 Stream::of($array)->take(10)->toArray(); Stream::of($array)->skip(5)->toArray(); Stream::of($array)->takeWhile(fn($n) => $n < 5)->toArray(); // 统计 Stream::of($array)->count(); Stream::of($array)->sum(); Stream::of($array)->min(); Stream::of($array)->max(); Stream::of($array)->average(); // 查找 Stream::of($array)->find(fn($n) => $n > 3); Stream::of($array)->anyMatch(fn($n) => $n === 2); Stream::of($array)->allMatch(fn($n) => $n > 0); // 合并 Stream::concat($stream1, $stream2)->toArray(); ``` ### CollectionUtil - 集合操作 [](#collectionutil---集合操作) ``` use yuandian\Tools\utils\CollectionUtil; // 基础操作 CollectionUtil::isEmpty($collection); CollectionUtil::contains($collection, $element); CollectionUtil::size($collection); // 集合运算 CollectionUtil::intersection($arr1, $arr2); // 交集 CollectionUtil::union($arr1, $arr2); // 并集 CollectionUtil::subtract($arr1, $arr2); // 差集 // 分组 CollectionUtil::groupBy($users, 'age'); CollectionUtil::partition($array, fn($v) => $v > 0); // 分页 CollectionUtil::paginate($array, 1, 10); CollectionUtil::paginateWithInfo($array, 1, 10); // 统计 CollectionUtil::stats($array); // min, max, avg, sum, count ``` 目录结构 ---- [](#目录结构) ``` src/ ├── bean/ # 实体转换 │ ├── BeanUtil.php │ └── mapper/ ├── utils/ # 工具类 │ ├── StrUtil.php │ ├── ArrUtil.php │ ├── DateUtil.php │ ├── ValidatorUtil.php │ ├── Stream.php │ ├── CollectionUtil.php │ └── ... ├── reflection/ # 反射 ├── feign/ # Feign客户端 ├── http/ # HTTP客户端 ├── enum/ # 枚举 ├── attribute/ # 属性注解 └── const/ # 常量 ``` 捐献 -- [](#捐献) [![](./wechat.png)](./wechat.png)[![](./alipay.png)](./alipay.png) ### Health Score 43 — FairBetter than 89% of packages Maintenance92 Actively maintained with recent releases Popularity9 Limited adoption so far Community12 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~43 days Recently: every ~64 days Total 9 Last Release 39d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/33216505?v=4)[yuan-dian](/maintainers/yuan-dian)[@yuan-dian](https://github.com/yuan-dian) --- Top Contributors [![yuan-dian](https://avatars.githubusercontent.com/u/33216505?v=4)](https://github.com/yuan-dian "yuan-dian (34 commits)") --- Tags phpmappertoolsbean ### Embed Badge ![Health badge](/badges/yuandian-tools/health.svg) ``` [![Health](https://phpackages.com/badges/yuandian-tools/health.svg)](https://phpackages.com/packages/yuandian-tools) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)