1. class
  2. Hypervel
  3. \
  4. RateLimiter
  5. \
  6. SlidingWindow

SlidingWindow

class SlidingWindow extends AdmissionPolicy

Constants

MAX_INTEGER

The largest integer represented exactly by every first-party store.
private MAX_ATTEMPTS

Methods

__construct(int $maxAttempts = 60, int $windowSeconds = 60, string $key = '', int $cost = 1, bool $global = false, Closure|null $afterCallback = null, Closure|null $responseCallback = null)

Create a new sliding-window limit.

AdmissionPolicy
by(Stringable|UnitEnum|string|int|null $key)

Set the key of the rate limit.

from  AdmissionPolicy
AdmissionPolicy
cost(int $cost)

Set the capacity consumed by each operation.

from  AdmissionPolicy
AdmissionPolicy
globally(bool $global = true)

Apply the policy without a named limiter scope.

from  AdmissionPolicy
AdmissionPolicy
after(callable $callback)

Set the callback that determines whether the operation should be consumed.

from  AdmissionPolicy
AdmissionPolicy
response(callable $callback)

Set the callback that generates a response when the limit is exceeded.

from  AdmissionPolicy
AdmissionPolicy
newInstance(string $key, int $cost, bool $global, Closure|null $afterCallback, Closure|null $responseCallback)

Create a copy with the given shared policy values.

string
normalizeKey(Stringable|UnitEnum|string|int|null $key)

Convert a caller key to its canonical string value.

from  AdmissionPolicy
static void
ensurePositive(string $name, int $value)

Validate a positive shared integer.

from  AdmissionPolicy
static int
multiply(int $value, int $multiplier, string $name)

Multiply positive rate limit values without losing integer precision.

from  AdmissionPolicy
static SlidingWindow
perSecond(int $maxAttempts, int $windowSeconds = 1)

Create a new per-second sliding-window limit.

static SlidingWindow
perMinute(int $maxAttempts, int $windowMinutes = 1)

Create a new per-minute sliding-window limit.

static SlidingWindow
perMinutes(int $windowMinutes, int $maxAttempts)

Create a new sliding-window limit using minutes as the window.

static SlidingWindow
perHour(int $maxAttempts, int $windowHours = 1)

Create a new per-hour sliding-window limit.

static SlidingWindow
perDay(int $maxAttempts, int $windowDays = 1)

Create a new per-day sliding-window limit.

Details

at line 19
__construct(int $maxAttempts = 60, int $windowSeconds = 60, string $key = '', int $cost = 1, bool $global = false, Closure|null $afterCallback = null, Closure|null $responseCallback = null)

Create a new sliding-window limit.

Parameters

int $maxAttempts
int $windowSeconds
string $key
int $cost
bool $global
Closure|null $afterCallback
Closure|null $responseCallback

in AdmissionPolicy at line 37
AdmissionPolicy by(Stringable|UnitEnum|string|int|null $key)

Set the key of the rate limit.

Parameters

Stringable|UnitEnum|string|int|null $key

Return Value

AdmissionPolicy

in AdmissionPolicy at line 51
AdmissionPolicy cost(int $cost)

Set the capacity consumed by each operation.

Parameters

int $cost

Return Value

AdmissionPolicy

in AdmissionPolicy at line 70
AdmissionPolicy globally(bool $global = true)

Apply the policy without a named limiter scope.

Parameters

bool $global

Return Value

AdmissionPolicy

in AdmissionPolicy at line 84
AdmissionPolicy after(callable $callback)

Set the callback that determines whether the operation should be consumed.

Parameters

callable $callback

Return Value

AdmissionPolicy

in AdmissionPolicy at line 98
AdmissionPolicy response(callable $callback)

Set the callback that generates a response when the limit is exceeded.

Parameters

callable $callback

Return Value

AdmissionPolicy

at line 93
protected AdmissionPolicy newInstance(string $key, int $cost, bool $global, Closure|null $afterCallback, Closure|null $responseCallback)

Create a copy with the given shared policy values.

Parameters

string $key
int $cost
bool $global
Closure|null $afterCallback
Closure|null $responseCallback

Return Value

AdmissionPolicy

in AdmissionPolicy at line 123
protected string normalizeKey(Stringable|UnitEnum|string|int|null $key)

Convert a caller key to its canonical string value.

Parameters

Stringable|UnitEnum|string|int|null $key

Return Value

string

in AdmissionPolicy at line 135
static protected void ensurePositive(string $name, int $value)

Validate a positive shared integer.

Parameters

string $name
int $value

Return Value

void

in AdmissionPolicy at line 149
static protected int multiply(int $value, int $multiplier, string $name)

Multiply positive rate limit values without losing integer precision.

Parameters

int $value
int $multiplier
string $name

Return Value

int

at line 47
static SlidingWindow perSecond(int $maxAttempts, int $windowSeconds = 1)

Create a new per-second sliding-window limit.

Parameters

int $maxAttempts
int $windowSeconds

Return Value

SlidingWindow

at line 55
static SlidingWindow perMinute(int $maxAttempts, int $windowMinutes = 1)

Create a new per-minute sliding-window limit.

Parameters

int $maxAttempts
int $windowMinutes

Return Value

SlidingWindow

at line 65
static SlidingWindow perMinutes(int $windowMinutes, int $maxAttempts)

Create a new sliding-window limit using minutes as the window.

Parameters

int $windowMinutes
int $maxAttempts

Return Value

SlidingWindow

at line 73
static SlidingWindow perHour(int $maxAttempts, int $windowHours = 1)

Create a new per-hour sliding-window limit.

Parameters

int $maxAttempts
int $windowHours

Return Value

SlidingWindow

at line 83
static SlidingWindow perDay(int $maxAttempts, int $windowDays = 1)

Create a new per-day sliding-window limit.

Parameters

int $maxAttempts
int $windowDays

Return Value

SlidingWindow