PHPackages                             qs9000/think-uuidv7 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. qs9000/think-uuidv7

ActiveLibrary[Utility & Helpers](/categories/utility)

qs9000/think-uuidv7
===================

ThinkPHP8 Redis-based UUIDv7 Generator for Distributed Systems

1.0.0(1mo ago)012Apache-2.0PHPPHP >=8.0

Since Apr 22Pushed 1mo agoCompare

[ Source](https://github.com/qs9000/think-uuidv7)[ Packagist](https://packagist.org/packages/qs9000/think-uuidv7)[ RSS](/packages/qs9000-think-uuidv7/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

think-uuidv7
============

[](#think-uuidv7)

基于 ThinkPHP 8 的 UUIDv7 生成器，专为分布式系统设计。

特性
--

[](#特性)

- **RFC 9562 兼容** - 严格遵循 UUIDv7 标准
- **自动安装** - Composer 安装后自动配置，无需手动复制文件
- **二进制存储** - 16 字节二进制格式，节省 55% 存储空间
- **分片支持** - 内置 shard\_id (0-255)，支持 256 个节点
- **分布式序列号** - Redis Lua 脚本保证原子性
- **批量生成** - 支持批量生成单调递增 UUID
- **ORM 集成** - ThinkPHP 模型类型转换器
- **时间可排序** - 同一节点内完全可排序

安装
--

[](#安装)

```
composer require qs9000/think-uuidv7
```

**安装后自动完成：**

- 配置文件复制到 `config/uuidv7.php`
- 服务自动注册

快速开始
----

[](#快速开始)

### 1. 注册服务（可选）

[](#1-注册服务可选)

如果自动注册失败，在 `application/provider.php` 中手动注册：

```