php ddd example

Arquitetura Hexagonal, DDD e CQRS em PHP

Exemplo de um aplicativo PHP usando os princípios Domain-Driven Design (DDD) e Command Query Responsibility Segregation (CQRS), mantendo o código o mais simples possível.

Dê uma olhada, brinque e divirta-se com isso. Estrelas são bem-vindas

Ver demonstração · Relatar um bug · Solicitar um recurso

Configuração do ambiente

Ferramentas necessárias

1. Instale o Docker
2. Clone este projeto: git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Vá para a pasta do projeto: cd php-ddd-example

Configuração do ambiente

1. Crie um arquivo de ambiente local ( cp .env .env.local ) se desejar modificar algum parâmetro

Execução de aplicativos

1. Instale todas as dependências e abra o projeto com o Docker executando: make build
2. Então você terá 3 aplicativos disponíveis (2 APIs e 1 Frontend):
   1. Back-end Mooc: http://localhost:8030/health-check
   2. Back-end de backoffice: http://localhost:8040/health-check
   3. Interface de backoffice: http://localhost:8041/health-check

Execução de testes

1. Instale as dependências caso ainda não tenha feito isso: make deps
2. Execute testes PHPUnit e Behat: make test

‍ Explicação do projeto

Este projeto tenta ser uma plataforma MOOC (Massive Open Online Course). É desacoplado de qualquer framework, mas possui algumas implementações de Symfony e Laravel.

Contextos limitados

• Mooc: Lugar para procurar se quiser ver algum código. Plataforma pública de cursos on-line abertos e massivos com usuários, vídeos, notificações e assim por diante.
• Backoffice: Aqui você encontrará os casos de uso necessários ao departamento de Suporte ao Cliente para gerenciar usuários, cursos, vídeos, etc.

Arquitetura Hexagonal

Este repositório segue o padrão de Arquitetura Hexagonal. Além disso, é estruturado usando modules . Com isso, podemos ver que a estrutura atual de um Contexto Delimitado é:

$ 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 

Padrão de repositório

Nossos repositórios tentam ser o mais simples possível, geralmente contendo apenas 2 métodos search e save . Caso precisemos de alguma consulta com mais filtros utilizamos o padrão Specification também conhecido como padrão Criteria . Portanto, adicionamos um método searchByCriteria .

Você pode ver um exemplo aqui e sua implementação aqui.

Agregados

Você pode ver um exemplo de agregado aqui. Todas as agregações devem estender AggregateRoot.

Barramento de comando

Existem 1 implementações do barramento de comando.

1. Sincronize usando o Symfony Message Bus.

Barramento de consulta

O Query Bus usa o Symfony Message Bus.

Ônibus de eventos

O Event Bus usa o Symfony Message Bus. O barramento MySql usa um MySql+Pulling como barramento. O barramento RabbitMQ usa a extensão RabbitMQ C.

Monitoramento

Cada vez que um evento de domínio é publicado, ele é exportado para o Prometheus. Você pode acessar o painel do Prometheus aqui.

Contribuindo

Faltam algumas coisas (adicionar arrogância, melhorar a documentação...), fique à vontade para adicionar se quiser! Se você quiser algumas orientações, não hesite em nos contatar :)

Extra

Este código foi mostrado no From framework acoplado código a #microservices através do #DDD talk e dúvidas foram respondidas no vídeo DDD y CQRS: Preguntas Frecuentes.

Usado nos cursos CodelyTV Pro:

• DDD em PHP
• Arquitetura Hexagonal
• CQRS: Segregação de responsabilidade de consulta de comando
• Comunicação entre microsserviços: arquitetura orientada a eventos

lembre-se de visitar nossos cursos

• Cursos codificados