Files
MrleeAdmin/backend/core/uuid/Snowflake.php
T
2026-08-31 11:33:59 +08:00

107 lines
2.5 KiB
PHP

<?php
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: https://madong.tech
*/
namespace core\uuid;
use madong\helper\Snowflake as SnowflakeGenerator;
use core\exception\handler\AdminException;
use RuntimeException;
use Webman\App;
/**
* 雪花ID生成
*
* @author Mr.April
* @since 1.0
* @method static generate()
*/
final class Snowflake
{
/**
* @var \madong\helper\Snowflake|null 唯一的 Snowflake 实例
*/
private static ?SnowflakeGenerator $instance = null;
/**
* 私有构造方法 —— 禁止外部 new
*/
private function __construct()
{
// 禁止外部实例化
}
/**
* 私有克隆方法 —— 禁止 clone
*/
private function __clone()
{
}
/**
* 私有反序列化方法 —— 禁止反序列化恢复对象
*/
public function __wakeup()
{
throw new RuntimeException("Cannot unserialize singleton.");
}
/**
* 获取唯一的 Snowflake 实例(懒加载)
*
* @return \madong\helper\Snowflake
*/
private static function instance(): SnowflakeGenerator
{
if (self::$instance === null) {
$nodeId = 1;
$workerId = App::worker() ? (App::worker()->id ?: 0) : 0;
self::$instance = new SnowflakeGenerator(
$nodeId,
$workerId,
array_merge([
'node_id_bits' => 3,
'worker_id_bits' => 7,
'sequence_bits' => 12,
], config('core.uuid.snowflake', []))
);
}
return self::$instance;
}
/**
* 静态代理调用:将所有静态方法调用转发到真正的 Snowflake 实例上
*
* @param string $method 方法名,比如 "generate"
* @param array $args 参数列表
*
* @return mixed
* @throws \core\exception\handler\AdminException
*/
public static function __callStatic(string $method, array $args)
{
$instance = self::instance();
if (!method_exists($instance, $method)) {
throw new AdminException(sprintf(
'Call to undefined method %s::%s()',
static::class,
$method
));
}
return $instance->{$method}(...$args);
}
}