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

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

一开始，我也用过 time() 拼接随机数、或者 uniqid()。
这些方案在小项目里够用，但一旦放到并发稍微高点的业务里，就会出现各种问题：

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

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

这个工具能做什么？

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

1. Snowflake（雪花算法）

  • 经典的分布式 ID 算法；
  • 生成的 ID 在高并发下也能保持唯一。
1
2
3
4
5
6
use Hejunjie\IdGenerator\IdGenerator;

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

echo $id; // 233953299479035905

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

2. Timestamp（时间戳 ID）

  • 由时间戳+序列号构成；
  • 可以加前缀，比如生成订单号：
1
2
3
4
5
6
use Hejunjie\IdGenerator\IdGenerator;

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

echo $id; // ORD1755778813238294503

3. Readable（可读 ID）

  • 格式类似：ORD-20250822-abcdef12；
  • 适合展示给用户，更容易记忆。
1
2
3
4
5
6
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；
  • 通用，跨系统时尤其常见。
1
2
3
4
5
6
use Hejunjie\IdGenerator\IdGenerator;

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

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

5. 自定义策略

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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

为什么要做这个库？

没有什么“高大上”的理由，就是因为自己项目里老是遇到这种需求：

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

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

安装方式

1
composer require hejunjie/id-generator

最后

这个小工具库目前还是 v1.0.0，功能比较基础。
如果你在项目里也有类似需求，可以拿来试试看。
要是你有更好的想法（比如加 ULID、新的生成算法等），非常欢迎提 PR 或者 Issue，一起完善。

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