php ddd example

Sechseckige Architektur, DDD und CQRS in PHP

Beispiel einer PHP-Anwendung, die die Prinzipien Domain-Driven Design (DDD) und Command Query Responsibility Segregation (CQRS) verwendet, um den Code so einfach wie möglich zu halten.

Schauen Sie es sich an, spielen Sie und haben Sie Spaß damit. Sterne sind willkommen

Demo ansehen · Einen Fehler melden · Eine Funktion anfordern

Umgebungseinrichtung

Benötigte Werkzeuge

1. Installieren Sie Docker
2. Klonen Sie dieses Projekt: git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Wechseln Sie in den Projektordner: cd php-ddd-example

Umgebungskonfiguration

1. Erstellen Sie eine lokale Umgebungsdatei ( cp .env .env.local ), wenn Sie einen Parameter ändern möchten

Anwendungsausführung

1. Installieren Sie alle Abhängigkeiten und rufen Sie das Projekt auf, während Docker Folgendes ausführt: make build
2. Dann stehen Ihnen 3 Apps zur Verfügung (2 APIs und 1 Frontend):
   1. Mooc-Backend: http://localhost:8030/health-check
   2. Backoffice-Backend: http://localhost:8040/health-check
   3. Backoffice-Frontend: http://localhost:8041/health-check

Testausführung

1. Installieren Sie die Abhängigkeiten, falls Sie dies noch nicht getan haben: make deps
2. PHPUnit- und Behat-Tests ausführen: make test

‍ Projekterklärung

Dieses Projekt versucht, eine MOOC-Plattform (Massive Open Online Course) zu sein. Es ist von jedem Framework entkoppelt, verfügt jedoch über einige Symfony- und Laravel-Implementierungen.

Begrenzte Kontexte

• Mooc: Hier können Sie nachschauen, wenn Sie Code sehen möchten. Massive öffentliche Plattform für offene Online-Kurse mit Benutzern, Videos, Benachrichtigungen usw.
• Backoffice: Hier finden Sie die Anwendungsfälle, die der Kundensupport benötigt, um Benutzer, Kurse, Videos usw. zu verwalten.

Sechseckige Architektur

Dieses Repository folgt dem Muster der hexagonalen Architektur. Außerdem ist es mithilfe von modules strukturiert. Daraus können wir erkennen, dass die aktuelle Struktur eines begrenzten Kontexts wie folgt aussieht:

$ tree - L 4 src

src
|-- Mooc // Company subdomain / Bounded Context: Features related to one of the company business lines / products
|   ` -- Videos // Some Module inside the Mooc context
|       |-- Application
|       |   |-- Create // Inside the application layer all is structured by actions
|       |   |   |-- CreateVideoCommand .php
|       |   |   |-- CreateVideoCommandHandler .php
|       |   |   ` -- VideoCreator .php
|       |   |-- Find
|       |   |-- Trim
|       |   ` -- Update
|       |-- Domain
|       |   |-- Video .php // The Aggregate of the Module
|       |   |-- VideoCreatedDomainEvent .php // A Domain Event
|       |   |-- VideoFinder .php
|       |   |-- VideoId .php
|       |   |-- VideoNotFound .php
|       |   |-- VideoRepository .php // The `Interface` of the repository is inside Domain
|       |   |-- VideoTitle .php
|       |   |-- VideoType .php
|       |   |-- VideoUrl .php
|       |   ` -- Videos .php // A collection of our Aggregate
|       ` -- Infrastructure // The infrastructure of our module
|           |-- DependencyInjection
|           ` -- Persistence
|               ` -- MySqlVideoRepository .php // An implementation of the repository
` -- Shared // Shared Kernel: Common infrastructure and domain shared between the different Bounded Contexts
    |-- Domain
    ` -- Infrastructure 

Repository-Muster

Unsere Repositories versuchen so einfach wie möglich zu sein und enthalten normalerweise nur zwei search und save . Wenn wir eine Abfrage mit mehr Filtern benötigen, verwenden wir das Specification , auch bekannt als Criteria . Deshalb fügen wir eine searchByCriteria -Methode hinzu.

Ein Beispiel können Sie hier und dessen Umsetzung hier sehen.

Aggregate

Ein Beispiel für ein Aggregat können Sie hier sehen. Alle Aggregate sollten die AggregateRoot erweitern.

Befehlsbus

Es gibt 1 Implementierungen des Befehlsbusses.

1. Synchronisieren Sie mit dem Symfony Message Bus.

Bus abfragen

Der Query Bus nutzt den Symfony Message Bus.

Veranstaltungsbus

Der Event Bus nutzt den Symfony Message Bus. Der MySql-Bus verwendet ein MySql+Pulling als Bus. Der RabbitMQ-Bus verwendet die RabbitMQ-C-Erweiterung.

Überwachung

Jedes Mal, wenn ein Domänenereignis veröffentlicht wird, wird es nach Prometheus exportiert. Hier können Sie auf das Prometheus-Panel zugreifen.

Mitwirken

Es fehlen einige Dinge (Swagger hinzufügen, Dokumentation verbessern ...), Sie können dies gerne hinzufügen, wenn Sie möchten! Wenn Sie einige Richtlinien wünschen, können Sie uns gerne kontaktieren :)

Extra

Dieser Code wurde im „Vom Framework gekoppelten Code an #Microservices durch #DDD-Vortrag“ gezeigt und Zweifel wurden im Video „DDD y CQRS: Preguntas Frecuentes“ beantwortet.

Wird in den CodelyTV Pro-Kursen verwendet:

• DDD in PHP
• Sechseckige Architektur
• CQRS: Verantwortungstrennung für Befehlsabfragen
• Kommunikation zwischen Mikrodiensten: Ereignisgesteuerte Architektur

Denken Sie daran, unsere Kurse zu besuchen

• Kurse codely