RetryOptions
in package
FinalYes
Политика повторов неудачных запросов.
Экспоненциальная выдержка с джиттером и уважением к Retry-After: задержка растёт по множителю до потолка, а случайная добавка размывает ретраи многих процессов во времени, предотвращая «стадный» повтор.
Table of Contents
Properties
- $baseDelayMs : int
- $jitterRatio : float
- $maxAttempts : int
- $maxDelayMs : int
- $multiplier : float
- $retryStatuses : array<string|int, mixed>
- Статусы, при которых запрос повторяется.
Methods
- __construct() : mixed
- delayForAttempt() : int
- Задержка перед указанной повторной попыткой.
- shouldRetryStatus() : bool
- Нужно ли повторять запрос после ответа с данным статусом.
Properties
$baseDelayMs read-only
public
int
$baseDelayMs
= 200
$jitterRatio read-only
public
float
$jitterRatio
= 0.2
$maxAttempts read-only
public
int
$maxAttempts
= 3
$maxDelayMs read-only
public
int
$maxDelayMs
= 5000
$multiplier read-only
public
float
$multiplier
= 2.0
$retryStatuses read-only
Статусы, при которых запрос повторяется.
public
array<string|int, mixed>
$retryStatuses
= self::DEFAULT_RETRY_STATUSES
Methods
__construct()
public
__construct([int $maxAttempts = 3 ][, int $baseDelayMs = 200 ][, int $maxDelayMs = 5000 ][, float $multiplier = 2.0 ][, float $jitterRatio = 0.2 ][, array<int, int> $retryStatuses = self::DEFAULT_RETRY_STATUSES ]) : mixed
Parameters
- $maxAttempts : int = 3
-
максимум попыток, включая первую (≥ 1)
- $baseDelayMs : int = 200
-
базовая задержка перед вторым запросом, мс
- $maxDelayMs : int = 5000
-
потолок задержки, мс
- $multiplier : float = 2.0
-
множитель экспоненциального роста (≥ 1)
- $jitterRatio : float = 0.2
-
доля случайной добавки к задержке, 0..1
- $retryStatuses : array<int, int> = self::DEFAULT_RETRY_STATUSES
-
HTTP-статусы для повтора
Tags
delayForAttempt()
Задержка перед указанной повторной попыткой.
public
delayForAttempt(int $attempt, float $random) : int
Parameters
- $attempt : int
-
номер завершившейся неудачей попытки (с 1)
- $random : float
-
случайное число 0..1 для джиттера
Return values
int —задержка в миллисекундах
shouldRetryStatus()
Нужно ли повторять запрос после ответа с данным статусом.
public
shouldRetryStatus(int $statusCode) : bool
Parameters
- $statusCode : int
-
HTTP-статус ответа