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

匿名上传

发布时间:2025-09-05 12:30:02

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

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

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

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

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

这个工具能做什么？

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

1. Snowflake（雪花算法）

经典的分布式 ID 算法；
生成的 ID 在高并发下也能保持唯一。

use HejunjieIdGeneratorIdGenerator;

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

echo $id; // 233953299479035905

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

2. Timestamp（时间戳 ID）

由时间戳+序列号构成；
可以加前缀，比如生成订单号：

use HejunjieIdGeneratorIdGenerator;

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

echo $id; // ORD1755778813238294503

3. Readable（可读 ID）

格式类似：ORD-20250822-abcdef12；
适合展示给用户，更容易记忆。

use HejunjieIdGeneratorIdGenerator;

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

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

4. UUID

熟悉的 UUID v1/v4；
通用，跨系统时尤其常见。

use HejunjieIdGeneratorIdGenerator;

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

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

5. 自定义策略

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

use HejunjieIdGeneratorContractsGenerator;
use HejunjieIdGeneratorIdGenerator;

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