0

0

php令牌桶算法在php中如何实现 php令牌桶(Token Bucket)限流算法实践

裘德小鎮的故事

裘德小鎮的故事

发布时间:2025-09-13 16:39:01

|

312人浏览过

|

来源于php中文网

原创

答案:令牌桶算法允许突发流量处理,而漏桶强制恒定速率输出;PHP中通过Redis的WATCH/MULTI/EXEC事务实现原子性操作,确保并发安全。

php令牌桶算法在php中如何实现 php令牌桶(token bucket)限流算法实践

在PHP中实现令牌桶(Token Bucket)限流算法,核心在于为每个需要限流的实体(如用户ID、IP地址或API端点)维护一个“令牌桶”的状态。这个状态通常包含桶内当前的令牌数量和上次补充令牌的时间戳。当一个请求到来时,系统会根据时间差计算桶内应补充的令牌,然后尝试从桶中消耗一个或多个令牌。如果令牌充足,请求被允许;如果不足,请求则被拒绝。这种机制通常借助Redis等高性能键值存储来实现原子性操作和状态持久化。

这里展示一个基于Redis的PHP令牌桶限流实现:

connect('127.0.0.1', 6379);

class TokenBucket
{
    private Redis $redis; // 也可以是Predis\Client实例
    private string $keyPrefix;
    private int $capacity; // 令牌桶的最大容量
    private float $refillRate; // 每秒补充的令牌数

    /**
     * @param Redis $redis Redis客户端实例
     * @param string $keyPrefix 用于构建Redis键的前缀,例如 'rate_limit'
     * @param int $capacity 令牌桶的最大容量
     * @param float $refillRate 每秒补充的令牌数
     */
    public function __construct(Redis $redis, string $keyPrefix, int $capacity, float $refillRate)
    {
        $this->redis = $redis;
        $this->keyPrefix = $keyPrefix;
        $this->capacity = $capacity;
        $this->refillRate = $refillRate;
    }

    /**
     * 尝试从令牌桶中消费指定数量的令牌。
     * @param string $identifier 唯一的限流对象标识符(例如用户ID、IP地址、API路径)
     * @param int $cost 消费的令牌数量,默认为1。
     * @return bool 如果成功消费令牌则返回true,否则返回false(表示被限流)。
     */
    public function consume(string $identifier, int $cost = 1): bool
    {
        // 如果单次请求消耗的令牌数超过桶容量,直接拒绝或视作配置错误
        if ($cost > $this->capacity) {
            error_log("Attempted to consume {$cost} tokens, but bucket capacity is {$this->capacity}. Identifier: {$identifier}");
            return false;
        }

        $bucketKey = $this->keyPrefix . ':' . $identifier;
        $now = microtime(true); // 获取当前微秒级时间戳

        // 使用Redis事务(WATCH/MULTI/EXEC)确保操作的原子性
        // 监控桶的键,如果在事务执行前被修改,事务将失败
        $this->redis->watch($bucketKey);

        // 获取桶的当前状态:上次补充时间 和 当前令牌数
        // 如果键不存在,则初始化为0和桶容量
        $data = $this->redis->hGetAll($bucketKey);
        $lastRefillTime = (float)($data['last_refill_time'] ?? 0);
        $currentTokens = (float)($data['current_tokens'] ?? $this->capacity);

        // 计算自上次补充以来应该补充的令牌数
        // 如果是第一次访问或时间倒退(理论上不应发生),则不补充
        $timeElapsed = max(0, $now - $lastRefillTime);
        $tokensToAdd = $timeElapsed * $this->refillRate;

        // 补充令牌,但不超过桶的容量
        $currentTokens = min($this->capacity, $currentTokens + $tokensToAdd);

        // 检查是否有足够的令牌进行消费
        if ($currentTokens >= $cost) {
            $currentTokens -= $cost; // 消耗令牌

            // 尝试执行事务:更新上次补充时间 和 当前令牌数
            $result = $this->redis->multi()
                ->hSet($bucketKey, 'last_refill_time', $now)
                ->hSet($bucketKey, 'current_tokens', $currentTokens)
                ->expire($bucketKey, $this->capacity / $this->refillRate * 2 + 60) // 设置过期时间,避免键无限增长
                ->exec();

            // 如果exec返回false,说明在watch期间键被修改,事务失败
            if ($result === false) {
                // 事务冲突,通常意味着并发请求。这里选择拒绝,实际应用可能需要重试或有其他策略
                error_log("Redis transaction failed for identifier: {$identifier}. Concurrent access detected.");
                return false;
            }
            return true; // 成功消费
        } else {
            // 令牌不足,释放watch
            $this->redis->unwatch();
            return false; // 拒绝请求
        }
    }

    /**
     * 获取指定标识符的令牌桶当前状态(用于调试或监控)。
     * @param string $identifier
     * @return array|false 桶的状态数组,或在Redis错误时返回false。
     */
    public function getBucketState(string $identifier): array|false
    {
        $bucketKey = $this->keyPrefix . ':' . $identifier;
        return $this->redis->hGetAll($bucketKey);
    }
}

/*
// 示例用法:
// 确保Redis服务正在运行
$redis = new Redis();
try {
    $redis->connect('127.0.0.1', 6379);
} catch (RedisException $e) {
    die("Could not connect to Redis: " . $e->getMessage());
}

// 创建一个令牌桶实例:
// 键前缀 'api_limit'
// 桶容量 10 个令牌
// 每秒补充 2 个令牌
$bucket = new TokenBucket($redis, 'api_limit', 10, 2);

$userId = 'user:456'; // 模拟一个用户的ID

echo "模拟对用户 {$userId} 的请求:\n";

for ($i = 1; $i <= 15; $i++) {
    if ($bucket->consume($userId)) {
        echo "请求 {$i}: 允许通过\n";
    } else {
        echo "请求 {$i}: 被限流\n";
        usleep(500000); // 被限流后等待0.5秒再尝试,给令牌补充时间
    }
    usleep(100000); // 每次请求间隔0.1秒
}

echo "\n最终令牌桶状态 for {$userId}:\n";
print_r($bucket->getBucketState($userId));

$redis->close();
*/

?>

为什么选择令牌桶算法而不是漏桶算法?它们有什么关键区别

在我看来,选择令牌桶(Token Bucket)还是漏桶(Leaky Bucket)算法,很大程度上取决于你对“流量平滑”和“突发处理”的侧重。我个人更偏爱令牌桶,因为它在保证整体限流效果的同时,提供了一定的弹性,能更好地应对Web应用中常见的突发流量。

漏桶算法可以想象成一个底部有固定小孔的桶,水滴(请求)以不规则的速度流入,但只能以恒定的速度从底部漏出(处理请求)。如果流入速度过快,桶满了,多余的水滴就溢出(请求被拒绝)。它的核心特点是强制输出速率恒定,无论系统当前负载如何,它都会以预设的固定速率处理请求。这对于后端服务非常友好,因为它保证了下游系统不会被瞬时高峰冲垮。但缺点是,即使系统当前完全空闲,它也无法处理超过固定速率的请求,显得有些“死板”,未能充分利用系统资源。

立即学习PHP免费学习笔记(深入)”;

Smodin AI Content Detector
Smodin AI Content Detector

多语种AI内容检测工具

下载

令牌桶算法则不同,它更像是一个定期生成令牌的机制,这些令牌被放入一个有最大容量的桶中。请求要被处理,必须先从桶中取走一个令牌。如果桶里没有令牌,请求就被拒绝。令牌桶的关键在于允许突发流量。如果桶里积累了足够的令牌(比如系统在一段时间内比较空闲),那么在短时间内,系统可以处理远超平均速率的请求。一旦这些积累的令牌被消耗完,它就会退化到与漏桶类似的固定速率处理模式。

这种“弹性”是令牌桶最大的吸引力。它在保障服务稳定性的前提下,给予了系统应对短期高峰的能力。对于很多互联网应用,如电商秒杀、API接口在特定时间点被集中调用等场景,令牌桶能够提供更好的用户体验,因为它允许系统在有余力时快速响应。而漏桶的严格平滑输出,虽然在某些极端强调稳定性的系统(如网络QoS)中有其不可替代的价值,但在多数Web服务中,我更倾向于令牌桶带来的灵活性。

在PHP中实现令牌桶算法时,如何确保并发安全和性能?

在PHP这种无状态、多进程/多线程(或协程)的环境中实现限流,确保并发安全和高性能是核心挑战。毕竟,PHP请求之间的数据共享需要外部存储。

  1. 原子性操作是关键: 这是确保并发安全的首要原则。当多个并发请求同时尝试更新令牌桶的状态(上次补充时间、当前令牌数)时,必须保证这些操作是原子的。如果简单地“读取-修改-写入”,很容易出现“写丢失”

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

1640

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1074

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

978

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

948

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1396

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1226

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1437

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1302

2023.11.13

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

7

2025.12.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 7.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号