源码系统概览
文章正文
IdGenerator 是一套 PHP 分布式 ID 生成组件源码，统一封装雪花算法等主流 ID 生成策略。
项目由 hejunjie 开源维护，仓库获 3 个 star 关注，采用 MIT 协议发布，以 2026.9.22 源码打包为版本口径，README 最后更新 2026 年 9 月。
源码简介
分布式场景下自增主键与随机 UUID 各有短板，组件统一封装多种 ID 策略，按业务场景选择。
雪花算法生成的 ID 趋势递增且不依赖数据库，订单号与分表主键场景表现良好。
工厂式创建入口让策略切换不改业务代码，后续替换生成方案成本极低。
组件以工厂方法统一暴露各生成策略，README 示例展示雪花策略的创建与调用，策略切换只需替换工厂参数而不动业务代码。
对比 UUID 库和数据库自增，区别在于 IdGenerator 的雪花算法趋势递增且不依赖库表。
| 对比维度 | IdGenerator | UUID 与自增 ID |
|---|---|---|
| 有序性 | 趋势递增利于索引 | UUID 无序索引差 |
| 依赖 | 不依赖数据库 | 自增依赖单库 |
| 策略切换 | 工厂统一入口 | 散落各处 |
| 并发 | 分布式唯一 | 自增有锁竞争 |
分库分表或订单系统的 ID 方案选型，接入组件后按场景选策略即可。
适用场景
- 订单号与支付流水号生成
- 分库分表场景的分布式主键
- 消息与日志的全局唯一标识
技术栈与运行环境
命名空间为 Hejunjie IdGenerator 系列，工厂方法统一创建不同策略的生成器。
纯 PHP 实现无额外依赖，composer 安装后即用。
功能亮点
- 雪花算法趋势递增 ID
- 多策略统一工厂入口
- 分布式场景唯一性保证
- 不依赖数据库自增
- MIT 协议商用友好
技术架构与部署指南
安装与部署提示
安装组件。
composer require hejunjie/id-generator创建雪花生成器并产出 ID。
use Hejunjie\IdGenerator\IdGenerator; $g = IdGenerator::make('snowflake'); echo $g->generate();把生成器注入订单服务等业务代码。
php -r "require 'vendor/autoload.php'; var_dump(class_exists('Hejunjie\\IdGenerator\\IdGenerator'));"截图与演示说明
本页配图采用 GitHub 仓库社交分享卡片，展示组件名称与 ID 生成定位。
README 以代码示例为主，展示工厂创建与 generate 调用的完整写法。
组件为纯计算类库，无运行界面截图，效果以示例代码与输出说明。
生成器的工厂入口让策略替换对业务代码透明，README 的示例输出可直接用于验证接入是否生效。
常见问题
问. IdGenerator 是什么
一套 PHP 分布式 ID 生成组件源码，统一封装雪花算法等策略。
问. 多实例部署会重复吗
按雪花算法的机器位规划配置 worker 标识即可避免重复。
问. 能做订单号吗
可以，趋势递增特征适合订单号前缀拼接使用。
问. 可以商用吗
采用 MIT 协议发布，保留版权与协议声明即可自由使用。
安全风险提示
多实例部署请确保机器标识唯一，避免 ID 冲突。
时钟回拨环境请评估策略后再上线。
项目采用 MIT 协议开源，商用保留版权与协议声明即可。
接入后请跟进仓库的后续版本更新，及时获取问题修复与功能改进。
使用中遇到问题可在仓库 issue 区反馈，附上复现步骤便于定位。
下载说明
本页提供 PHP 分布式 ID 组件完整源码打包下载，含组件代码与示例。
压缩包内含完整组件代码、双语文档与使用示例，解压后按 README 步骤安装依赖即可接入现有项目运行。
GitHub项目开源地址 https://github.com/zxc7563598/php-id-generator
