php ddd example

Architecture hexagonale, DDD et CQRS en PHP

Exemple d' application PHP utilisant les principes de conception pilotée par domaine (DDD) et de séparation des responsabilités des requêtes de commande (CQRS) en gardant le code aussi simple que possible.

Jetez un oeil, jouez et amusez-vous avec ça. Les étoiles sont les bienvenues

Voir la démo · Signaler un bug · Demander une fonctionnalité

Configuration de l'environnement

Outils nécessaires

1. Installer Docker
2. Clonez ce projet : git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Déplacer vers le dossier du projet : cd php-ddd-example

Configuration de l'environnement

1. Créez un fichier d'environnement local ( cp .env .env.local ) si vous souhaitez modifier un paramètre

Exécution des applications

1. Installez toutes les dépendances et lancez le projet avec l'exécution de Docker : make build
2. Vous aurez alors 3 applications disponibles (2 API et 1 Frontend) :
   1. Back-end Mooc : http://localhost:8030/health-check
   2. Back-end back-office : http://localhost:8040/health-check
   3. Front-office du back-office : http://localhost:8041/health-check

Exécution des tests

1. Installez les dépendances si vous ne l'avez pas déjà fait : make deps
2. Exécuter les tests PHPUnit et Behat : make test

‍ Explication du projet

Ce projet tente d'être une plateforme MOOC (Massive Open Online Course). Il est découplé de tout framework, mais il possède quelques implémentations Symfony et Laravel.

Contextes délimités

• Mooc : endroit où regarder si vous voulez voir du code. Plateforme publique Massive Open Online Courses avec utilisateurs, vidéos, notifications, etc.
• Backoffice : vous trouverez ici les cas d'utilisation nécessaires au service Support Client afin de gérer les utilisateurs, les cours, les vidéos, etc.

Architecture hexagonale

Ce référentiel suit le modèle de l'architecture hexagonale. De plus, il est structuré à l'aide modules . Avec cela, nous pouvons voir que la structure actuelle d’un contexte borné est :

$ 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 

Modèle de référentiel

Nos référentiels essaient d'être aussi simples que possible et ne contiennent généralement que 2 méthodes search et save . Si nous avons besoin d'une requête avec plus de filtres, nous utilisons le modèle Specification également connu sous le nom de modèle Criteria . Nous ajoutons donc une méthode searchByCriteria .

Vous pouvez voir un exemple ici et sa mise en œuvre ici.

Agrégats

Vous pouvez voir un exemple d'agrégat ici. Tous les agrégats doivent étendre AggregateRoot.

Bus de commande

Il existe 1 implémentations du bus de commande.

1. Synchronisez à l'aide du Symfony Message Bus.

Bus de requête

Le Query Bus utilise le Symfony Message Bus.

Bus événementiel

Le bus d'événements utilise le bus de messages Symfony. Le bus MySql utilise un MySql+Pulling comme bus. Le bus RabbitMQ utilise l'extension RabbitMQ C.

Surveillance

Chaque fois qu'un événement de domaine est publié, il est exporté vers Prometheus. Vous pouvez accéder au panneau Prometheus ici.

Contribuer

Il manque certaines choses (ajouter du swagger, améliorer la documentation...), n'hésitez pas à ajouter ceci si vous le souhaitez ! Si vous souhaitez des directives, n'hésitez pas à nous contacter :)

Supplémentaire

Ce code a été présenté dans la discussion Du code couplé au framework aux #microservices via #DDD et les doutes ont reçu une réponse dans la vidéo DDD et CQRS : Preguntas Frecuentes.

Utilisé dans les cours CodelyTV Pro :

• DDD en PHP
• Architecture Hexagonale
• CQRS : ségrégation des responsabilités des requêtes de commande
• Communication entre microservicios : Architecture événementielle

pensez à visiter nos cours

• Cours codés