php ddd example

Arquitectura Hexagonal, DDD y CQRS en PHP

Ejemplo de una aplicación PHP que utiliza los principios de diseño basado en dominio (DDD) y segregación de responsabilidad de consulta de comandos (CQRS) manteniendo el código lo más simple posible.

Echa un vistazo, juega y diviértete con esto. las estrellas son bienvenidas

Ver demostración · Informar un error · Solicitar una función

Configuración del entorno

herramientas necesarias

1. Instalar ventana acoplable
2. Clona este proyecto: git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Mover a la carpeta del proyecto: cd php-ddd-example

Configuración del entorno

1. Cree un archivo de entorno local ( cp .env .env.local ) si desea modificar algún parámetro

Ejecución de aplicaciones

1. Instale todas las dependencias y abra el proyecto con Docker ejecutándose: make build
2. Entonces tendrás 3 aplicaciones disponibles (2 API y 1 Frontend):
   1. Backend de Mooc: http://localhost:8030/health-check
   2. Backend de backoffice: http://localhost:8040/health-check
   3. Frontend de backoffice: http://localhost:8041/health-check

Ejecución de pruebas

1. Instala las dependencias si no lo has hecho anteriormente: make deps
2. Ejecutar pruebas PHPUnit y Behat: make test

‍ Explicación del proyecto

Este proyecto pretende ser una plataforma MOOC (Massive Open Online Course). Está desacoplado de cualquier marco, pero tiene algunas implementaciones de Symfony y Laravel.

Contextos acotados

• Mooc: lugar para buscar si quieres ver algún código. Plataforma pública masiva de Cursos Abiertos Online con usuarios, vídeos, notificaciones, etc.
• Backoffice: Aquí encontrarás los casos de uso que necesita el departamento de Atención al Cliente para gestionar usuarios, cursos, vídeos, etc.

Arquitectura hexagonal

Este repositorio sigue el patrón de Arquitectura Hexagonal. Además, está estructurado mediante modules . Con esto podemos ver que la estructura actual de un Contexto Acotado es:

$ 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 

Patrón de repositorio

Nuestros repositorios intentan ser lo más simples posible y generalmente solo contienen 2 métodos: search y save . Si necesitamos alguna consulta con más filtros utilizamos el patrón Specification también conocido como patrón Criteria . Entonces agregamos un método searchByCriteria .

Puedes ver un ejemplo aquí y su implementación aquí.

Agregados

Puedes ver un ejemplo de un agregado aquí. Todos los agregados deben extender AggregateRoot.

Autobús de comando

Hay 1 implementaciones del bus de comando.

1. Sincronización utilizando el bus de mensajes de Symfony.

Autobús de consulta

El bus de consultas utiliza el bus de mensajes de Symfony.

Autobús de eventos

El bus de eventos utiliza el bus de mensajes de Symfony. El bus MySql utiliza MySql+Pulling como bus. El bus RabbitMQ utiliza la extensión RabbitMQ C.

Escucha

Cada vez que se publica un evento de dominio, se exporta a Prometheus. Puedes acceder al panel de Prometheus aquí.

Contribuyendo

Faltan algunas cosas (añadir arrogancia, mejorar la documentación...), ¡siéntete libre de añadir esto si quieres! Si quieres algunas pautas no dudes en contactarnos :)

Extra

Este código se mostró en la charla Del código acoplado del framework a #microservicios a través de #DDD y las dudas fueron respondidas en el video DDD y CQRS: Preguntas Frecuentes.

Utilizado en los cursos de CodelyTV Pro:

• DDD en PHP
• Arquitectura Hexagonal
• CQRS: Segregación de responsabilidades de consultas de comandos
• Comunicación entre microservicios: Arquitectura basada en eventos

recuerda visitar nuestros cursos

• Cursos codificados