What is idempotency in PHP development?

Idempotency ensures that an operation can be performed multiple times without changing the result beyond the initial application, preventing duplicate records or unintended side effects.

Does it work with standard PHP frameworks like Laravel or Symfony?

Yes, it is designed to work with any PHP architecture, including Laravel, Symfony, and custom DDD or Hexagonal implementations by analyzing patterns in Actions, Controllers, and Handlers.

Why is this skill critical for e-commerce applications?

It prevents critical errors like double-charging customers, duplicate shipping, or creating multiple orders when network failures cause clients to retry requests.

Can it detect missing unique constraints in databases?

Yes, it identifies write operations in handlers and services that lack the necessary guards or unique constraints to prevent duplicate data entry.

PHP Idempotency Checker

Name: PHP Idempotency Checker
Author: dykyi-roman

bydykyi-roman

•

API Development

Analyzes PHP applications to detect and fix idempotency violations that cause duplicate writes and inconsistent states during retries.

This skill empowers developers to build resilient PHP applications by scanning code for common idempotency pitfalls in POST/PUT endpoints, command handlers, and critical service operations. It identifies risky patterns like payment processing without deduplication, unsafe retry loops, and missing unique constraints, providing clear guidance and code fixes to ensure that repeated operations yield the same result without side effects. It is particularly useful for systems implementing DDD, CQRS, and event-driven architectures where message redelivery and network retries are common.

Key Features

01Analyzes retry loops for unsafe side effects like duplicate email or SMS delivery

02Categorizes issues by severity with actionable code fix recommendations

03Detects missing Idempotency-Key headers in REST API endpoints

04Identifies non-idempotent CQRS command handlers lacking execution tracking

05Flags high-risk payment and financial operations without deduplication guards

0647 GitHub stars

Use Cases

01Securing public-facing APIs against duplicate resource creation from client retries

02Refactoring legacy command handlers to support safe message redelivery in distributed systems

03Auditing financial and payment processing logic for double-charge risks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-idempotency

For use in Claude.ai and ChatGPT

Download Skill