ThrottlesExceptions

class ThrottlesExceptions (View source)

Properties

protected string $key

The developer specified key that the rate limiter should use.
protected bool $byJob

Indicates whether the throttle key should use the job's UUID.
protected int $maxAttempts

The maximum number of attempts allowed before rate limiting applies.
protected int $decayMinutes

The number of minutes until the maximum attempts are reset.
protected int $retryAfterMinutes

The number of minutes to wait before retrying the job after an exception.
protected callable $whenCallback

The callback that determines if rate limiting should apply.
protected string $prefix

The prefix of the rate limiter key.
protected RateLimiter $limiter

The rate limiter instance.

Methods

void __construct(int $maxAttempts = 10, int $decayMinutes = 10)

Create a new middleware instance.
mixed handle(mixed $job, callable $next)

Process the job.
$this when(callable $callback)

Specify a callback that should determine if rate limiting behavior should apply.
$this withPrefix(string $prefix)

Set the prefix of the rate limiter key.
$this backoff(int $backoff)

Specify the number of minutes a job should be delayed when it is released (before it has reached its max exceptions).
string getKey(mixed $job)

Get the cache key associated for the rate limiter.
$this by(string $key)

Set the value that the rate limiter should be keyed by.
$this byJob()

Indicate that the throttle key should use the job's UUID.
int getTimeUntilNextRetry(string $key)

Get the number of seconds that should elapse before the job is retried.

Details

void __construct(int $maxAttempts = 10, int $decayMinutes = 10)

Create a new middleware instance.

Parameters

int $maxAttempts
int $decayMinutes

Return Value

void

mixed handle(mixed $job, callable $next)

Process the job.

Parameters

mixed $job
callable $next

Return Value

mixed

$this when(callable $callback)

Specify a callback that should determine if rate limiting behavior should apply.

Parameters

callable $callback

Return Value

$this

$this withPrefix(string $prefix)

Set the prefix of the rate limiter key.

Parameters

string $prefix

Return Value

$this

$this backoff(int $backoff)

Specify the number of minutes a job should be delayed when it is released (before it has reached its max exceptions).

Parameters

int $backoff

Return Value

$this

protected string getKey(mixed $job)

Get the cache key associated for the rate limiter.

Parameters

mixed $job

Return Value

string

$this by(string $key)

Set the value that the rate limiter should be keyed by.

Parameters

string $key

Return Value

$this

$this byJob()

Indicate that the throttle key should use the job's UUID.

Return Value

$this

protected int getTimeUntilNextRetry(string $key)

Get the number of seconds that should elapse before the job is retried.

Parameters

string $key

Return Value

int

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/9.x/Illuminate/Queue/Middleware/ThrottlesExceptions.html