php ddd example

Шестиугольная архитектура, DDD и CQRS в PHP

Пример приложения PHP, использующего принципы доменно-ориентированного проектирования (DDD) и разделения ответственности за запросы команд (CQRS), позволяющие максимально упростить код.

Смотрите, играйте и получайте от этого удовольствие. Звезды приветствуются

Посмотреть демо · Сообщить об ошибке · Запросить функцию

Настройка среды

Необходимые инструменты

1. Установить Докер
2. Клонируйте этот проект: git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Перейдите в папку проекта: cd php-ddd-example

Конфигурация среды

1. Создайте файл локальной среды ( cp .env .env.local ), если вы хотите изменить какой-либо параметр.

Выполнение приложения

1. Установите все зависимости и запустите проект с выполнением Docker: make build
2. Тогда у вас будет 3 доступных приложения (2 API и 1 интерфейс):
   1. Серверная часть Mooc: http://localhost:8030/health-check
   2. Серверная часть бэк-офиса: http://localhost:8040/health-check
   3. Интерфейс бэк-офиса: http://localhost:8041/health-check

Выполнение тестов

1. Установите зависимости, если вы не сделали этого раньше: make deps
2. Выполните тесты PHPUnit и Behat: make test

‍ Объяснение проекта

Этот проект пытается стать платформой MOOC (массовый открытый онлайн-курс). Он отделен от какой-либо инфраструктуры, но имеет некоторые реализации на Symfony и Laravel.

Ограниченные контексты

• Mooc: Место, куда можно заглянуть, если хотите увидеть какой-нибудь код. Публичная платформа Massive Open Online Courses с пользователями, видео, уведомлениями и т. д.
• Бэк-офис: здесь вы найдете варианты использования, необходимые отделу поддержки клиентов для управления пользователями, курсами, видео и т. д.

Шестиугольная архитектура

Этот репозиторий соответствует шаблону шестиугольной архитектуры. Кроме того, он структурирован с использованием modules . При этом мы видим, что текущая структура ограниченного контекста:

$ 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 

Шаблон репозитория

Наши репозитории стараются быть максимально простыми и обычно содержат только два метода: search и save . Если нам нужен запрос с большим количеством фильтров, мы используем шаблон Specification , также известный как шаблон Criteria . Поэтому мы добавляем метод searchByCriteria .

Вы можете увидеть пример здесь и его реализацию здесь.

Агрегаты

Посмотреть пример агрегата можно здесь. Все агрегаты должны расширять AggregateRoot.

Командный автобус

Существует 1 реализация командной шины.

1. Синхронизируйте с помощью шины сообщений Symfony.

Запрос шины

Шина запросов использует шину сообщений Symfony.

Автобус для мероприятий

Шина событий использует шину сообщений Symfony. Шина MySql использует MySql+Pulling в качестве шины. Шина RabbitMQ использует расширение RabbitMQ C.

Мониторинг

Каждый раз, когда событие домена публикуется, оно экспортируется в Prometheus. Вы можете получить доступ к панели Prometheus здесь.

Содействие

Некоторых вещей не хватает (добавьте чванства, улучшите документацию...), не стесняйтесь добавлять это, если хотите! Если вам нужны какие-то рекомендации, свяжитесь с нами :)

Дополнительный

Этот код был показан в разделе «От кода, связанного с инфраструктурой, до #микросервисов через #DDD», а также в видео «DDD и CQRS: Preguntas Frecuentes».

Используется в курсах CodelyTV Pro:

• ДДД в PHP
• Архитектура Шестиугольная
• CQRS: разделение ответственности за командный запрос
• Коммуникация между микросервисами: архитектура, управляемая событиями

не забудьте посетить наши курсы

• Курсы