php如何限制函数调用次数_php装饰器模式与redis记录调用日志

使用装饰器模式结合Redis实现PHP函数调用限制,通过FunctionCallLimiter类封装限流与日志功能,利用Redis的INCR和EXPIRE命令控制单位时间内调用次数并自动过期,支持按用户维度设置阈值(如每小时最多5次),超出则记录错误并抛出异常;同时将每次调用时间、参数等信息存入Redis列表用于后续审计与监控,实现业务逻辑与控制逻辑解耦,提升系统安全性与可维护性。

在实际开发中,我们常常需要控制某个函数的调用频率或总次数,比如防止接口被恶意刷请求、限制用户操作频率等。PHP 可以结合装饰器模式与 Redis 实现灵活的调用次数限制,并记录调用日志。

使用装饰器模式封装函数调用逻辑

装饰器模式允许我们在不修改原函数代码的前提下,为其附加额外功能(如限流、日志记录)。我们可以创建一个通用的装饰器类来包装目标函数。

例如,定义一个 FunctionCallLimiter 类:

class FunctionCallLimiter 
{
    private $redis;
    private $callback;
    private $key;
    private $limit;
    private $ttl;
public function __construct($redis, callable $callback, string $key, int $limit, int $ttl = 3600)
{
    $this->redis = $redis;
    $this->callback = $callback;
    $this->key = $key;
    $this->limit = $limit;
    $this->ttl = $ttl;
}

public function __invoke(...$args)
{
    $count = $this->redis->get($this->key);
    if ($count >= $this->limit) {
        error_log("Function call limit exceeded for key: {$this->key}");
        throw new RuntimeException("调用次数超限");
    }

    // 记录调用日志
    $this->redis->incr($this->key);
    $this->redis->expire($this->key, $this->ttl);

    // 写入调用日志(可选:记录时间、参数等)
    $logKey = "log:" . $this->key;
    $this->redis->rPush($logKey, json_encode([
        'time' => date('Y-m-d H:i:s'),
        'args' => $args
    ]));
    $this->redis->expire($logKey, $this->ttl * 2); // 日志保留稍久

    return call_user_func_array($this->callback, $args);
}

}

通过 Redis 控制调用次数

Redis 的原子操作 INCREXPIRE 非常适合用于实现调用计数和自动过期。每次调用前检查当前计数是否超过阈值。

示例:限制用户每小时最多调用某函数 5 次

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

// 被限制的函数 $sendEmail = function($to, $subject) { echo "发送邮件至: $to, 主题: $subject\n"; // 实际发送逻辑... };

// 用户唯一标识(如用户ID + 函数名) $userId = 12345; $key = "user:{$userId}:send_email"; $limit = 5; $ttl = 3600; // 1小时

// 使用装饰器包装函数 $limitedSendEmail = new FunctionCallLimiter($redis, $sendEmail, $key, $limit, $ttl);

// 调用(模拟多次) try { $limitedSendEmail('test@example.com', '欢迎信'); } catch (RuntimeException $e) { echo "错误: " . $e->getMessage() . "\n"; }

查看调用日志与监控

通过 Redis 存储的日志键可以方便地查询历史调用情况,便于排查问题或分析行为。

获取某用户的调用记录:

$logKey = "log:user:12345:send_email";
$logs = $redis->lRange($logKey, 0, -1);
foreach ($logs as $log) {
    print_r(json_decode($log, true));
}

这种方式支持快速检索、定期清理,也便于对接监控系统。

基本上就这些。用装饰器解耦业务逻辑与控制逻辑,用 Redis 实现高性能计数与持久化日志,是 PHP 中实现函数调用限制的实用方案。