php-ddd-conventions
/php-ddd-conventions
Podpowiada w kodzie domenowym PHP i Symfony obiekty wartości, specyfikacje i serwisy domenowe zgodnie z zasadami DDD.
- Autor
- fabiensalles ↗
- Repozytorium
- claude-marketplace ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Podpowiada w kodzie domenowym PHP i Symfony obiekty wartości, specyfikacje i serwisy domenowe zgodnie z zasadami DDD.
Wyzwalacze z opisu
Oryginalny opis (EN)
ACTIVATE when writing or modifying domain layer code in PHP/Symfony, creating value objects, specifications, domain services, or domain interfaces. ACTIVATE for 'domain', 'DDD', 'hexagonal', 'ports and adapters', 'domain purity' in PHP context. Provides PHP/Symfony-specific examples for cross-language OOP DDD principles defined in craft:ddd-principles. DO NOT use for: infrastructure/controller code, Doctrine mapping, general architecture questions.
Jak działa
- PHP/Symfony-specific: Forbidden in Domain Layer
- PHP/Symfony-specific: Allowed in Domain Layer
- PHP/Symfony-specific: SPI Pattern
- Quick Reference (PHP-specific)
Podgląd SKILL.md
---
name: php-ddd-conventions
description: "ACTIVATE when writing or modifying domain layer code in PHP/Symfony, creating value objects, specifications, domain services, or domain interfaces. ACTIVATE for 'domain', 'DDD', 'hexagonal', 'ports and adapters', 'domain purity' in PHP context. Provides PHP/Symfony-specific examples for cross-language OOP DDD principles defined in craft:ddd-principles. DO NOT use for: infrastructure/controller code, Doctrine mapping, general architecture questions."
---
# DDD Conventions — PHP / Symfony
> The **cross-language OOP DDD principles** (domain purity, ports & adapters, dependency direction, bounded contexts, aggregates, value objects) are defined in `craft:ddd-principles`. This skill keeps PHP/Symfony-specific lists and patterns.
## PHP/Symfony-specific: Forbidden in Domain Layer
In a Symfony codebase, these concrete classes / types are typical infrastructure leaks:
- `Symfony\Component\HttpFoundation\File\UploadedFile` → use `string $filePath` or a domain abstraction (`UploadFile` model)
- HTTP classes: `Request`, `Response`, `RedirectResponse`, etc.
- Database / ORM: Doctrine entities, repository **implementations**, `EntityManagerInterface`
- Framework-specific validators / constraints (Symfony validator components)
## PHP/Symfony-specific: Allowed in Domain Layer
- Pure PHP types (`string`, `int`, `array`, `DateTimeInterface`, `DateTimeImmutable`)
- Domain value objects (final readonly classes, no framework dependency)
- **Domain interfaces** (defined in `Domain/`, implemented in `Infrastructure/`)
- DTO classes from contracts packages (e.g. `vendor/acme/contracts`)
## PHP/Symfony-specific: SPI Pattern
In a Symfony hexagonal project, the convention for the **Service Provider Interface** (SPI):
- The interface lives in the **Domain** layer (e.g. `src/Domain/Subscription/Port/SubscriptionRepository.php`).
- The concrete implementation lives in **Infrastructure** (e.g. `src/Infrastructure/Doctrine/DoctrineSubscriptionRepository.php`).
- Domain code depends on the interface only.
## Quick Reference (PHP-specific)
| Forbidden in domain | Why |
|---------------------|-----|
| `UploadedFile` | Form-internal type — use domain `UploadFile` |
| `Request` / `Response` | HTTP-internal — should never reach the domain |
| Doctrine entities | ORM-internal — keep domain models pure |
| Symfony validators | Framework-internal — use domain invariants |
| Allowed in domain | Examples |
|-------------------|----------|
| Pure PHP types | `string`, `int`, `DateTimeImmutable`, `array` |
| Domain VOs | `final readonly class Money { … }` |
| Domain interfaces | SPI ports, defined in domain, implemented in infra |
| Contract DTOs | From `vendor/acme/contracts` |
Wersje
W bazie nie ma innych skilli o nazwie php-ddd-conventions.
Migawka bazy z 13.11.2026 · wersja paczki c03094d69589 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100ddd-principles
Stosuje zasady DDD w obiektowych językach przy projektowaniu warstwy domeny: konteksty ograniczone, agregaty, obiekty wartości, czystość warstw, porty i adaptery oraz kierunek zależności. - 95php-refactoring
Prowadzi refaktoryzację kodu PHP i Symfony, wydzielając metody i upraszczając kod zgodnie z regułami refaktoryzacji. - 95clean-architecture
Podaje wzorce implementacji Clean Architecture, Hexagonal Architecture i Domain-Driven Design w PHP 8.3+ z Symfony 7.x: encje, value objects, agregaty, refaktoryzacja legacy i testowalne backendy. - 100symfony
Wspiera pracę z Symfony: jądro HTTP w PHP, Twig, Doctrine ORM, serwisy i MakerBundle przy budowie aplikacji PHP i usług webowych. - 100domain-driven-design
Pomaga modelować domenę w Symfony: agregaty, encje, value objects, zdarzenia domenowe, repozytoria i język wszechobecny. - 100tactical-ddd
Wykrywa anemiczne modele domenowe, waliduje je i refaktoryzuje do bogatych modeli oraz wymusza wzorce taktycznego DDD: encje, obiekty wartości, agregaty, serwisy domenowe i zdarzenia domenowe.