标签: php-tool-youhujun

概述

密钥管理服务提供了安全密钥生成功能,支持自定义字符类型和长度,使用密码学安全的随机数生成器。

安装

use YouHuJun\Tool\App\Facades\V1\Utils\Sign\KeyManagerFacade;

游鹄君2026/2/17大约 6 分钟

认证签名服务使用文档

概述

认证签名服务提供了 HMAC-SHA256 签名生成功能,用于API接口认证、数据完整性校验等场景。

安装

use YouHuJun\Tool\App\Facades\V1\Utils\Sign\AuthSignFacade;

游鹄君2026/2/17大约 6 分钟

ShardFacae使用说明

概述

ShardFacade 提供了数据库分片计算功能,支持分库分表策略,适用于大流量、大数据量的业务场景。通过业务ID(用户UID/店铺UID等业务实体ID)计算分片信息,实现数据的水平拆分。

特性

✅ 分库分表: 支持同时进行数据库分片和表分片
✅ 多配置支持: 支持业务表和映射表等多场景独立配置
✅ 微服务适配: 每个服务可配置独立的分片规则
✅ 简单易用: 提供便捷的静态方法调用
✅ 强制传参: 所有静态方法必须传configKey,避免配置混淆

游鹄君2026/2/2大约 13 分钟

SnowflakeFacade使用说明

概述

SnowflakeFacade 提供了基于雪花算法的分布式唯一ID生成功能，基于 godruoyi/php-snowflake 库实现。雪花算法生成的ID是递增的、唯一的、有序的，非常适合用于用户ID、订单ID等场景。

特性

✅ 全局唯一: 在分布式系统中保证ID唯一性
✅ 时间有序: ID按时间递增，便于排序
✅ 高性能: 本地生成，无需网络请求
✅ 可配置: 支持自定义机器ID和起始时间
✅ 无依赖: 不依赖外部配置文件或环境变量

游鹄君2026/1/14大约 9 分钟

YouHuJun PHP Tool 命令行工具

命令前缀

可以使用以下几种方式调用生成命令:

1. 使用 `youhujun` 前缀 (推荐)

php youhujun make:facade <路径> [描述]
php youhujun make:service <路径> [描述]
php youhujun call:facade <路径> [描述]

游鹄君2026/1/9大约 1 分钟

CommonException 使用指南

概述

CommonException 是一个通用的业务异常类,用于在应用程序中表示预期的业务逻辑错误。抛出异常时返回标准格式的数组:

[
    'code' => 错误码,
    'error' => 错误标识,
    'msg' => 错误信息
]

游鹄君2026/1/9大约 5 分钟

CalendarFacade 使用说明

概述

CalendarFacade 提供了农历和阳历日期的相互转换功能。

农历转阳历

数组格式转换

use YouHuJun\Tool\App\Facades\V1\Calendar\CalendarFacade;

// 将农历 2023年11月25日 转换为阳历
$solar = CalendarFacade::lunarToSolar(2023, 11, 25);

// 返回: [2024, 1, 6]  (2024年1月6日)
echo $solar[0] . '-' . $solar[1] . '-' . $solar[2];

游鹄君2026/1/9大约 3 分钟

ExcelFacade 使用说明

概述

ExcelFacade 提供了Excel文件的导入导出功能，基于 PhpSpreadsheet 库实现。

导出Excel

基本导出

use YouHuJun\Tool\App\Facades\V1\Excel\ExcelFacade;

// 准备数据
$column = [['姓名', '年龄', '性别']];
$data = [
    ['张三', 20, '男'],
    ['李四', 25, '女'],
    ['王五', 30, '男']
];

// 导出到文件
ExcelFacade::exportExcelData(
    $column,       // 列名
    $data,         // 数据
    '用户列表',     // 文件标题
    storage_path('app/excel')  // 保存路径
);

游鹄君2026/1/9大约 3 分钟

抖音登录服务使用文档

概述

抖音登录服务提供了抖音小游戏和抖音小程序的登录功能,通过 code 换取 openid 和 session_key。

安装

use YouHuJun\Tool\App\Facades\V1\DouYin\Login\DouYinLoginFacade;

游鹄君2026/1/9大约 4 分钟

二维码生成服务使用文档

概述

QrcodeFacade 是二维码生成服务的静态门面类,提供了灵活的二维码生成功能,支持多种输出模式和自定义配置。使用静态代理模式调用,简单便捷。

配置参数

1. `$config` - 配置参数

$config = [
    'logoPath' => '/path/to/logo.png',           // 可选: Logo图片路径
    'noticeInfo' => '扫码关注',                   // 可选: 二维码下方提示文字,默认"二维码"
    'qrcodePath' => '/path/to/save/qrcode.png',  // 可选: 保存路径(mode=1时必填)
    'size' => 300,                               // 可选: 二维码尺寸,默认300
    'margin' => 10,                              // 可选: 二维码边距,默认10
    'logoResizeToWidth' => 50,                   // 可选: Logo宽度,默认50
];