Why use Redis for idempotency storage?

Redis supports atomic operations like SETNX and provides built-in TTL (Time-To-Live) features, which are crucial for preventing race conditions and automatically cleaning up old keys.

Does this skill follow PHP standards?

Yes, it generates PSR-15 compatible middleware and uses modern PHP 8.4 features like readonly classes and typed properties, adhering to Clean Architecture principles.

How does the middleware handle a duplicate request?

The middleware checks the storage for the provided Idempotency-Key; if found, it bypasses the application logic and returns the previously stored response immediately.

What is idempotency in API development?

Idempotency ensures that making the same request multiple times has the same effect as making it once, preventing duplicate actions like multiple charges or duplicate database entries.

PHP Idempotency Handler Generator

Name: PHP Idempotency Handler Generator
Author: dykyi-roman

bydykyi-roman

•

API 开发

Generates robust PSR-15 middleware and Redis-backed storage for safe request deduplication in PHP 8.4 applications.

This skill automates the creation of a complete idempotency handling infrastructure for PHP 8.4 projects, following clean architecture and DDD principles. It generates a PSR-15 compatible middleware that intercepts incoming requests, validates idempotency keys using UUID v4 Value Objects, and utilizes Redis for atomic storage. This infrastructure is essential for building resilient APIs, preventing duplicate operations in payment processing, order fulfillment, and webhook handling by ensuring retried requests are handled safely without side effects while returning cached responses.

主要功能

0147 GitHub stars

02Includes TTL-based expiration support to manage storage growth

03Provides UUID v4 IdempotencyKey Value Objects for strict validation

04Produces automated Unit Tests for all generated components

05Generates PSR-15 Middleware for seamless HTTP request interception

06Implements Redis-backed storage with atomic SETNX operations

使用场景

01Ensuring safe retries for order creation in e-commerce APIs

02Preventing duplicate charges in payment processing systems

03Deduplicating incoming webhook deliveries from external services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code create-idempotency-handler

For use in Claude.ai and ChatGPT

Download Skill