如何使用Composer引入 PHP-Sequence 库生成不重复的分布式唯一 ID-composer-PHP中文网

composer安装php-sequence失败是因为该包未注册到packagist，需手动在composer.json中添加vcs仓库源指向github地址，并用taoqili/php-sequence:dev-master安装；其类无命名空间且不支持psr-4自动加载，须显式require sequence.php文件，并注意bcmath扩展、时钟回拨及实例生命周期管理。

如何使用composer引入 php-sequence 库生成不重复的分布式唯一 id

Composer 安装 php-sequence 失败或找不到包

php-sequence 并不是 Packagist 官方注册的公开包，直接运行 composer require php-sequence/php-sequence 会报错 Could not find package php-sequence/php-sequence。它实际托管在 GitHub，需手动添加仓库源。

确认项目根目录下 composer.json 中已声明 "repositories"，指向其 GitHub 地址：

"repositories": [
  {
    "type": "vcs",
    "url": "https://github.com/taoqili/php-sequence"
  }
]

执行 composer require taoqili/php-sequence:dev-master（注意作者用户名是 taoqili，不是 php-sequence）
若提示 minimum-stability 不允许安装 dev 分支，需临时放宽：加 --stability=dev 或在 composer.json 中设 "minimum-stability": "dev"

初始化 Sequence 实例时抛出 Class 'Sequence' not found

该库未遵循 PSR-4 自动加载规范，类文件不按命名空间路径存放，不能靠 Composer 自动加载。必须手动 require 其核心文件。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

安装后，找到 vendor/taoqili/php-sequence/src/Sequence.php

在使用前显式引入：

require_once __DIR__ . '/vendor/taoqili/php-sequence/src/Sequence.php';

类名就是 Sequence，无命名空间，直接 new：
```
$seq = new Sequence(1, 1); // node_id, machine_id
```
跳过 autoload 后仍报错？检查 PHP 版本 —— 该库依赖 bcadd 和 bcsub，需启用 bcmath 扩展

生成 ID 重复或时间戳回退导致高位冲突

php-sequence 是 Snowflake 变种，ID 结构为 timestamp(41b) + node_id(10b) + machine_id(12b) + sequence(12b)，但实现中对时钟回拨处理较弱。

不要跨多台机器共用相同 node_id 或 machine_id，否则秒级内并发 > 4096 会撞 sequence
服务器时间校准（如 NTP）可能造成时钟回拨，此时库不会阻塞等待，而是直接抛出异常 SequenceException: Clock moved backwards
生产环境务必捕获该异常并降级（如 sleep 1ms 后重试），或改用带时钟保护的替代方案（如 Twitter Snowflake 的 Java 实现或更成熟的 PHP 库 spatie/uuid 配合 Redis 生成）
注意：它默认使用 microtime(true) 计算毫秒，但截取的是整数毫秒部分，精度不如原生 Snowflake 的 10ms 级别

如何安全用于高并发 Web 请求场景

Sequence 实例不是线程安全的，PHP-FPM 下每个请求是独立进程，但若在长生命周期（如 Swoole Worker）中复用同一实例，sequence 计数器会竞争。

Web 场景建议每次请求新建实例：
```
$seq = new Sequence((int)$_SERVER['SERVER_ADDR'], getmypid());
```
（用 IP+PID 构造唯一 node_id）
Swoole 场景必须按 Worker 进程隔离：在 onWorkerStart 中 new 实例并存入全局变量，禁止跨 Worker 复用
避免在 CLI 脚本中循环调用而不 sleep —— 它每毫秒最多生成 4096 个 ID，超速会触发 sequence 溢出并抛异常
生成的 ID 是字符串（因含大整数），若存 MySQL，字段类型必须为 BIGINT UNSIGNED 或 VARCHAR(20)，不能用 INT

实际用起来，最麻烦的不是 ID 生成逻辑本身，而是时钟同步和实例生命周期管理。尤其在容器化部署里，node_id 得从环境变量或服务发现里拿，不能硬编码。