yii3-idempotency — PSR-15 middleware для Idempotency-Key, которое не даёт обработать POST, PUT и PATCH повторно
$ composer require rasuvaeff/yii3-idempotency
$middleware = new IdempotencyMiddleware( keyExtractor: new HeaderIdempotencyKeyExtractor(), storage: new InMemoryIdempotencyStorage($clock), responseFactory: $responseFactory, clock: $clock, scopeResolver: new RequestAttributeScopeResolver(attribute: 'user'),who a key belongs to ttlSeconds: 3600,);
PSR-15 middleware для Idempotency-Key. Один и тот же ключ с тем же телом запускает обработчик один раз.
Повторённые или дважды отправленные запросы запускают обработчик дважды. Без привязки к вызывающему один клиент мог бы ещё и воспроизвести чужой ключ или заблокировать его.
Idempotency-Replay: true.422; дубликат, который ещё выполняется, отвечает 409.scopeResolver обязателен: ключи разделяются по вызывающим.DomainFailureRenderer и FailureClassifier кешируют доменные ошибки, поэтому InsufficientFunds не выполняется повторно.cacheableRedirectStatuses кеширует 303 для форм Post/Redirect/Get.Set-Cookie, Date и hop-by-hop заголовки никогда не сохраняются.Кеширует детерминированные доменные ошибки как воспроизводимые ответы; баги и сбои инфраструктуры остаются повторяемыми.
$middleware = new IdempotencyMiddleware( keyExtractor: new HeaderIdempotencyKeyExtractor(), storage: $storage, responseFactory: $responseFactory, clock: $clock, scopeResolver: new RequestAttributeScopeResolver(attribute: 'user'), domainFailureRenderer: $renderer,your DomainFailureRenderer failureClassifier: new DefaultFailureClassifier([optional overrides MisconfiguredGatewayException::class => FailureKind::Bug, ]),);
Сохраняет и повторяет редирект 303, чтобы двойная отправка формы не запускала обработчик дважды.
$middleware = new IdempotencyMiddleware( // ... keyExtractor, storage, responseFactory, clock, scopeResolver ... cacheableRedirectStatuses: [303],);
Ограничивает ключи идемпотентности вызывающим и эндпоинтом, чтобы одинаковые ключи не конфликтовали.
// caller + "METHOD /path" — the wiring the bundled config builds by default$scopeResolver = new CompositeScopeResolver( new RequestAttributeScopeResolver(attribute: 'user'), new RequestTargetScopeResolver(),); // caller + an explicit namespace shared by related endpoints$scopeResolver = new CompositeScopeResolver( new RequestAttributeScopeResolver(attribute: 'user'), new IdempotencyScope('orders'),);
yii3-idempotency-db даёт DbIdempotencyStorage; yii3-idempotency-redis — Redis-backend.
Анонимные вызывающие делят одно пространство имён, поэтому не прячьте приватные данные вызывающего за анонимным идемпотентным эндпоинтом. SharedKeyspaceScopeResolver — задокументированный отказ от изоляции, безопасный только для единственного субъекта.
от него зависят: yii3-idempotency-db(3), yii3-idempotency-redis(3)
Первый релиз v1.0.0 — 2026-06-12, всего релизов: 9.
| v2.3.0 | 2026-10-27 |
| v2.2.0 | 2026-10-26 |
| v2.1.0 | 2026-08-29 |
| v2.0.1 | 2026-08-25 |
| v2.0.0 | 2026-08-22 |
| v1.1.1 | 2026-07-25 |
| v1.1.0 | 2026-07-24 |
| v1.0.1 | 2026-06-27 |
| v1.0.0 | 2026-06-12 |
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу