What is an Idempotent Consumer?

An Idempotent Consumer is a design pattern that ensures a message or request is processed only once, even if it is received multiple times, by checking a unique key before execution.

Is the generated code compatible with modern PHP?

Yes, the skill is specifically designed for PHP 8.4+, utilizing modern features like readonly classes, enums, and constructor property promotion.

Which storage backends does this skill support?

It generates implementations for both PDO-based databases (using unique constraints) and Redis (using SETNX and EXPIRE) to store idempotency keys.

How does it handle race conditions?

The skill implements atomic operations, such as database 'INSERT ... ON CONFLICT' or Redis 'SETNX', to ensure that if two identical messages arrive simultaneously, only one can be processed.

PHP Idempotent Consumer Generator

Name: PHP Idempotent Consumer Generator
Author: dykyi-roman

bydykyi-roman

•

API Development

Generates robust message deduplication infrastructure for PHP 8.4 applications to ensure exactly-once processing guarantees.

This skill automates the implementation of the Idempotent Consumer pattern within PHP architectures, providing a complete framework for message deduplication using Database or Redis backends. It follows Domain-Driven Design (DDD) and Clean Architecture principles by generating deterministic key value objects, storage ports, and middleware wrappers. It is essential for developers building resilient distributed systems where preventing duplicate actions—such as double payments, redundant inventory updates, or duplicate webhook processing—is critical for data integrity.

Key Features

01Dual storage backend support for PDO-compatible databases and Redis with TTL

02Deterministic idempotency key generation using message IDs and handler names

03Middleware-based integration for transparent message processing and result tracking

04Atomic race condition handling using database constraints and Redis SETNX

0545 GitHub stars

06Generation of comprehensive unit tests for domain, application, and infrastructure layers

Use Cases

01Ensuring exactly-once semantics in event-driven microservices and message queue consumers

02Preventing duplicate charges during payment processing message replays

03Safely handling redundant webhook deliveries from external third-party services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code create-idempotent-consumer

For use in Claude.ai and ChatGPT

Download Skill