订单号老是撞车?我写了个通用 PHP ID 生成器

在日常开发里,我们经常会遇到这种情况:

  • 需要给订单生成唯一编号;
  • 想给日志 或者资源加个标识;
  • 或者需要一个不会重复的 ID,用作数据库主键。

一开始,我也用过 time() 拼接随机数、或者 uniqid()。

这些方案在小项目里够用,但一旦放到并发稍微高点的业务里,就会出现各种问题:

  • time() 很容易撞车(同一毫秒可能生成多个);
  • uniqid() 看上去独特,其实也可能重复,而且格式不太好看;
  • 有些场景希望 ID 可读,比如订单号,最好一眼能分辨。

久而久之,我在不同项目里反复造轮子,干脆就写了一个通用的小工具,把常见的 ID 生成方式都封装起来了。


这个工具能做什么?

它支持几种常见的生成策略:

1. Snowflake(雪花算法)

  • 经典的分布式 ID 算法;
  • 生成的 ID 在高并发下也能保持唯一。
php 复制代码
use Hejunjie\IdGenerator\IdGenerator;

$generator = new IdGenerator::make('snowflake')
$id = $generator->generate();

echo $id; // 233953299479035905

还能解析出来生成时间、机器 ID 等信息,排查问题时很方便。


2. Timestamp(时间戳 ID)

  • 由时间戳+序列号构成;
  • 可以加前缀,比如生成订单号:
php 复制代码
use Hejunjie\IdGenerator\IdGenerator;

$generator = new IdGenerator::make('timestamp', ['prefix' => 'ORD']);
$id = $generator->generate();

echo $id; // ORD1755778813238294503

3. Readable(可读 ID)

  • 格式类似:ORD-20250822-abcdef12;
  • 适合展示给用户,更容易记忆。
php 复制代码
use Hejunjie\IdGenerator\IdGenerator;

$generator = new IdGenerator::make('readable', ['prefix' => 'ORD', 'randomLength' => 6]);
$id = $generator->generate();

echo $id; // ORD-2025-08-21-7ABP01

4. UUID

  • 熟悉的 UUID v1/v4;
  • 通用,跨系统时尤其常见。
php 复制代码
use Hejunjie\IdGenerator\IdGenerator;

$generator = new IdGenerator::make('uuid', ['version' => 'v4']);
$id = $generator->generate();

echo $id; // ad0f5dfc-4a3d-4c2a-853b-aa3a3d9062aa

5. 自定义策略

如果你想要特别的格式,比如 USER-随机数,也能自己实现。

php 复制代码
use Hejunjie\IdGenerator\Contracts\Generator;
use Hejunjie\IdGenerator\IdGenerator;

class MyCustomGenerator implements Generator
{
    public function __construct(private string $prefix = 'MY') {}

    public function generate(): string
    {
        return $this->prefix . '-' . random_int(1000, 9999);
    }
    public function parse(string $id): array
    {
        return ['id' => $id];
    }
}

IdGenerator::registerStrategy('custom', function (array $config) {
    return new MyCustomGenerator($config['prefix'] ?? 'MY');
});

$generator = new IdGenerator::make('custom', ['prefix' => 'ORD']);
$id = $generator->generate();

echo $id; // ORD-4128

为什么要做这个库?

没有什么"高大上"的理由,就是因为自己项目里老是遇到这种需求:

  • 想要一个统一的生成方式,避免东拼西凑;
  • 想要可扩展,方便以后加新的策略;
  • 想要轻量,直接安装就能用,不依赖庞大的框架。

于是就写了这么个东西,后来觉得或许对别人也有用,就开源了。


安装方式

bash 复制代码
composer require hejunjie/id-generator

最后

这个小工具库目前还是 v1.0.0,功能比较基础。

如果你在项目里也有类似需求,可以拿来试试看。

要是你有更好的想法(比如加 ULID、新的生成算法等),非常欢迎提 PR 或者 Issue,一起完善。

项目地址 👉 zxc7563598/php-id-generator

相关推荐
FungLeo9 小时前
FengCMS · PHP+MySQL 升级实录 ·三重 MD5 迁移 password_hash:老站密码怎么无痛升级
mysql·php·哈希算法·密码安全·fengcms
ServBay11 小时前
PHP 8.6 最新发布:语法更新、实用函数与升级要点
后端·php
FungLeo18 小时前
FengCMS ·PHP+MySQL 升级实录 · 安全加固的克制:一份“不做什么“清单,比修了几个漏洞更重要
mysql·安全·php·安全加固·fengcms
.痞老板.1 天前
java ee--网络编程套接字
网络·java-ee·php
JianZhen✓3 天前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo3 天前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
FungLeo3 天前
FengCMS · PHP+MySQL 升级实录 · 一个不懂PHP 的后端,三天 216次提交完成十三年老站安全升级(项目复盘)
mysql·安全·php·安全加固·fengcms
pps-key3 天前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
驭渊的小故事3 天前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Risehuxyc4 天前
来自PHP项目devnexen的回信
开发语言·php