PHPackages ledc/snowflake - 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. ledc/snowflake ActiveLibrary[Utility & Helpers](/categories/utility) ledc/snowflake ============== 雪花算法的PHP实现 v2.0.0(9mo ago)0328↓25%2MITPHP Since Dec 31Pushed 9mo ago1 watchersCompare [ Source](https://github.com/ledccn/snowflake)[ Packagist](https://packagist.org/packages/ledc/snowflake)[ Docs](https://github.com/ledccn/snowflake)[ RSS](/packages/ledc-snowflake/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (3)Used By (2) [![](https://camo.githubusercontent.com/d0a5c4d460ca256f5829eb93f2ccae01706a13f8c0322495523a76bc13a149c4/68747470733a2f2f7777772e706e676b65792e636f6d2f706e672f66756c6c2f3130352d313035323233355f736e6f77666c616b652d706e672d7472616e73706172656e742d6261636b67726f756e642d736e6f77666c616b652d776974682d636c6561722d6261636b67726f756e642e706e67)](https://camo.githubusercontent.com/d0a5c4d460ca256f5829eb93f2ccae01706a13f8c0322495523a76bc13a149c4/68747470733a2f2f7777772e706e676b65792e636f6d2f706e672f66756c6c2f3130352d313035323233355f736e6f77666c616b652d706e672d7472616e73706172656e742d6261636b67726f756e642d736e6f77666c616b652d776974682d636c6561722d6261636b67726f756e642e706e67) An ID Generator for PHP based on Snowflake Algorithm (Twitter announced). 说明 -- [](#说明) 雪花算法的 PHP 实现 [![file](https://camo.githubusercontent.com/114d145c4abf55943f607009906b700af54a066203005a4eb16a9b9d2f52eea0/68747470733a2f2f696d616765732e676f6472756f79692e636f6d2f636f6d6d656e74732f3230313930382f31332f5f313536353636383037325f41626b526e685161596b2e706e67)](https://camo.githubusercontent.com/114d145c4abf55943f607009906b700af54a066203005a4eb16a9b9d2f52eea0/68747470733a2f2f696d616765732e676f6472756f79692e636f6d2f636f6d6d656e74732f3230313930382f31332f5f313536353636383037325f41626b526e685161596b2e706e67) Snowflake 是 Twitter 内部的一个 ID 生算法，可以通过一些简单的规则保证在大规模分布式情况下生成唯一的 ID 号码。其组成为： - 第一个 bit 为未使用的符号位。 - 第二部分由 41 位的时间戳（毫秒）构成，他的取值是当前时间相对于某一时间的偏移量。 - 第三部分和第四部分的 5 个 bit 位表示数据中心和机器ID，其能表示的最大值为 2^5 -1 = 31。 - 最后部分由 12 个 bit 组成，其表示每个工作节点**每毫秒**生成的序列号 ID，同一毫秒内最多可生成 2^12 -1 即 4095 个 ID。 需要注意的是： - 在分布式环境中，5 个 bit 位的 datacenter 和 worker 表示最多能部署 31 个数据中心，每个数据中心最多可部署 31 台节点。 - 41 位的二进制长度最多能表示 2^41 -1 毫秒即 69 年，所以雪花算法最多能正常使用 69 年，为了能最大限度的使用该算法，你应该为其指定一个开始时间。 > 由上可知，雪花算法生成的 ID 并不能保证唯一，如当两个不同请求同一时刻进入相同的数据中心的相同节点时，而此时该节点生成的 sequence 又是相同时，就会导致生成的 ID 重复。 所以要想使用雪花算法生成唯一的 ID，就需要保证同一节点同一毫秒内生成的序列号是唯一的。基于此，我们在 SDK 中集成了多种序列号提供者： - RandomSequenceResolver（随机生成） - RedisSequenceResolver （基于 redis psetex 和 incrby 生成） - LaravelSequenceResolver（基于 redis psetex 和 incrby 生成） - SwooleSequenceResolver（基于 swoole\_lock 锁） - FileLockResolver（基于 PHP 文件锁） > **Warning**RandomSequenceResolver 序列号提供者在高并发情况下可能会导致生成的 ID 重复，如果你的应用场景中可能会出现高并发的情况，建议使用 RedisSequenceResolver 或者 LaravelSequenceResolver。 要求 -- [](#要求) 1. PHP >= 8.1 2. **[Composer](https://getcomposer.org/)** 安装 -- [](#安装) ``` $ composer require ledc/snowflake -vvv ``` 使用 -- [](#使用) 1. 简单使用. ``` $snowflake = new \Ledc\Snowflake\Snowflake; $snowflake->id(); // 1537200202186752 ``` 2. 指定数据中心ID及机器ID. ``` $snowflake = new \Ledc\Snowflake\Snowflake($datacenterId, $workerId); $snowflake->id(); ``` 3. 指定开始时间. ``` $snowflake = new \Ledc\Snowflake\Snowflake; $snowflake->setStartTimeStamp(strtotime('2019-08-08')*1000); $snowflake->id(); ``` 4. 使用索尼雪花算法 ``` $sonyflake = new \Ledc\Snowflake\Sonyflake; $sonyflake->id(); ``` 高级 -- [](#高级) 1. 在 Laravel 中使用 因为 SDK 相对简单，我们并没有提供 Laravel 的扩展包，你可通过下面的方式快速集成到 Laravel 中。 ``` // App\Providers\AppServiceProvider use Ledc\Snowflake\Snowflake; use Ledc\Snowflake\LaravelSequenceResolver; class AppServiceProvider extends ServiceProvider { /** * Register any application services. * * @return void */ public function register() { $this->app->singleton('snowflake', function ($app) { return (new Snowflake()) ->setStartTimeStamp(strtotime('2019-10-10')*1000) ->setSequenceResolver(new LaravelSequenceResolver($app->get('cache.store'))); }); } } } ``` 2. 自定义序列号解决器 你可以通过实现 Ledc\\Snowflake\\SequenceResolver 接口来自定义序列号解决器。 ``` class YourSequence implements SequenceResolver { /** * {@inheritdoc} */ public function sequence(int $currentTime) { // Just test. return mt_rand(0, 1); } } // usage $snowflake->setSequenceResolver(new YourSequence); $snowflake->id(); ``` 你也可以直接使用闭包： ``` $snowflake = new \Ledc\Snowflake\Snowflake; $snowflake->setSequenceResolver(function ($currentTime) { static $lastTime; static $sequence; if ($lastTime == $currentTime) { ++$sequence; } else { $sequence = 0; } $lastTime = $currentTime; return $sequence; })->id(); ``` License ------- [](#license) MIT ### Health Score 33 — LowBetter than 75% of packages Maintenance56 Moderate activity, may be stable Popularity14 Limited adoption so far Community12 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~577 days Total 2 Last Release 292d ago Major Versions v1.0.0 → v2.0.02025-07-30 ### Community Maintainers ![](https://www.gravatar.com/avatar/4af14254189bc74029cc40f4206f8006872b0cd092c680201f204a85a490f143?d=identicon)[ledccn](/maintainers/ledccn) --- Top Contributors [![ledccn](https://avatars.githubusercontent.com/u/53997080?v=4)](https://github.com/ledccn "ledccn (3 commits)") --- Tags unique-idsnowflake algorithmphp snowflakelaravel snowflakeorder idunique order idphp unique idsonyflakephp sonyflake ### Embed Badge ![Health badge](/badges/ledc-snowflake/health.svg) ``` [![Health](https://phpackages.com/badges/ledc-snowflake/health.svg)](https://phpackages.com/packages/ledc-snowflake) ``` ### Alternatives [godruoyi/php-snowflake An ID Generator for PHP based on Snowflake Algorithm (Twitter announced). 8582.3M61](/packages/godruoyi-php-snowflake)[pocketmine/pocketmine-mp A server software for Minecraft: Bedrock Edition written in PHP 3.5k74.6k86](/packages/pocketmine-pocketmine-mp)[pocketmine/math PHP library containing math related code used in PocketMine-MP 45573.2k14](/packages/pocketmine-math)[pocketmine/nbt PHP library for working with Named Binary Tags 42574.4k13](/packages/pocketmine-nbt)[pocketmine/snooze Thread notification management library for code using the pthreads extension 19565.1k8](/packages/pocketmine-snooze)[danog/telegram-entities A library to work with Telegram UTF-16 styled text entities. 23203.1k5](/packages/danog-telegram-entities) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)