Skip to content
YII3-IDEMPOTENCY(3)Руководство по PHP-библиотекам rasuvaeffYII3-IDEMPOTENCY(3)

ИМЯ ​

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. Один и тот же ключ с тем же телом запускает обработчик один раз.

Повторённые или дважды отправленные запросы запускают обработчик дважды. Без привязки к вызывающему один клиент мог бы ещё и воспроизвести чужой ключ или заблокировать его.

  • Тот же ключ и тот же payload воспроизводят сохранённый ответ с заголовком Idempotency-Replay: true.
  • Тот же ключ с другим payload отвечает 422; дубликат, который ещё выполняется, отвечает 409.
  • Отпечаток покрывает метод, путь, query и тело.
  • scopeResolver обязателен: ключи разделяются по вызывающим.
  • По умолчанию кешируются 2xx-ответы; остальные статусы снимают claim.
  • 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.02026-10-27
v2.2.02026-10-26
v2.1.02026-08-29
v2.0.12026-08-25
v2.0.02026-08-22
v1.1.12026-07-25
v1.1.02026-07-24
v1.0.12026-06-27
v1.0.02026-06-12
rasuvaeff/yii3-idempotency 2.3.0мутационный порог 98%зависят пакетов 2YII3-IDEMPOTENCY(3)

/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу