What PHP versions are supported by this skill?

This skill is specifically optimized for PHP 8.3+ and takes full advantage of modern features like readonly classes, constructor property promotion, and strict typing.

Does this skill require the Symfony framework?

While the skill provides specific implementation patterns and adapters for Symfony 7.x, the core Domain and Application layers are designed to be framework-agnostic.

How does this architecture improve software testing?

By decoupling the domain logic from infrastructure (like databases), it allows you to run high-speed unit tests using in-memory repository doubles without needing a live database or framework container.

Can I use this skill to refactor existing legacy PHP projects?

Yes, the skill provides a roadmap for identifying business logic and extracting it into a clean Domain layer, facilitating a gradual and safe migration away from legacy 'spaghetti' code.

PHP Clean Architecture & DDD

Name: PHP Clean Architecture & DDD
Author: giuseppe-trisciuoglio

bygiuseppe-trisciuoglio

•

165

•

API Development

Implements enterprise-grade Clean Architecture and Domain-Driven Design patterns in PHP 8.3+ and Symfony 7.x.

This skill empowers developers to build highly maintainable, testable, and framework-independent PHP applications by enforcing the principles of Clean Architecture and Hexagonal (Ports & Adapters) design. It provides structured guidance for organizing domain entities, value objects, and application use cases while ensuring that business logic remains decoupled from infrastructure concerns like Symfony or Doctrine. Whether refactoring legacy code or architecting new enterprise systems, this skill streamlines the implementation of DDD tactical patterns and CQRS within modern PHP environments to ensure long-term code quality and scalability.

Key Features

01165 GitHub stars

02Implementation patterns for immutable Value Objects and behavior-rich Entities using modern PHP 8.3 features.

03Hexagonal Architecture (Ports & Adapters) patterns to decouple core logic from external APIs and databases.

04Guidance for framework-agnostic business logic that remains testable without Symfony or Doctrine dependencies.

05Standardized directory structure for Clean Architecture layers: Domain, Application, Adapter, and Infrastructure.

06Command/Query Responsibility Segregation (CQRS) setup with dedicated Handlers, DTOs, and readonly Commands.

Use Cases

01Designing complex domain models using DDD tactical patterns like Aggregates, Value Objects, and Domain Events.

02Refactoring monolithic legacy PHP codebases into modular, testable, and modern architectures.

03Architecting scalable enterprise-level backends with Symfony 7.x and PHP 8.3.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add giuseppe-trisciuoglio/developer-kit clean-architecture

For use in Claude.ai and ChatGPT

Download Skill