Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

php-ddd-conventions

/php-ddd-conventions

Podpowiada w kodzie domenowym PHP i Symfony obiekty wartości, specyfikacje i serwisy domenowe zgodnie z zasadami DDD.

Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

domainDDDhexagonalports and adaptersdomain purity
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

  1. PHP/Symfony-specific: Forbidden in Domain Layer
  2. PHP/Symfony-specific: Allowed in Domain Layer
  3. PHP/Symfony-specific: SPI Pattern
  4. Quick Reference (PHP-specific)
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 283 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.