php ddd example

PHP のヘキサゴナル アーキテクチャ、DDD および CQRS

ドメイン駆動設計 (DDD) とコマンド クエリ責任分離 (CQRS) の原則を使用して、コードを可能な限りシンプルに保つ PHP アプリケーションの例。

見て、遊んで、楽しんでください。スターは大歓迎です

デモを見る · バグを報告する · 機能をリクエストする

環境設定

必要なツール

1. Dockerをインストールする
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 (Massive Open Online Course) プラットフォームを目指しています。どのフレームワークからも切り離されていますが、Symfony と Laravel の実装がいくつかあります。

境界のあるコンテキスト

• Mooc: コードを見たい場合に見る場所。ユーザー、ビデオ、通知などを備えた大規模なオープン オンライン コースのパブリック プラットフォーム。
• バックオフィス: ユーザー、コース、ビデオなどを管理するためにカスタマー サポート部門が必要とするユースケースがここにあります。

六角形の建築

このリポジトリは、ヘキサゴナル アーキテクチャ パターンに従っています。また、 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 2 つのメソッドのみが含まれています。より多くのフィルターを含むクエリが必要な場合は、 Criteriaパターンとも呼ばれるSpecificationパターンを使用します。そこで、 searchByCriteriaメソッドを追加します。

ここで例とその実装をここで見ることができます。

集合体

ここで集計の例を確認できます。すべての集約は AggregateRoot を拡張する必要があります。

コマンドバス

コマンドバスの実装は 1 つあります。

1. Symfony メッセージ バスを使用して同期します。

クエリバス

クエリ バスは Symfony メッセージ バスを使用します。

イベントバス

イベント バスは Symfony メッセージ バスを使用します。 MySql バスは MySql+Pulling をバスとして使用します。 RabbitMQ バスは RabbitMQ C 拡張機能を使用します。

監視

ドメイン イベントが公開されるたびに、Prometheus にエクスポートされます。ここから Prometheus パネルにアクセスできます。

貢献する

不足しているものがいくつかあります (Swagger の追加、ドキュメントの改善など)。必要に応じて自由に追加してください。ガイドラインが必要な場合は、お気軽にお問い合わせください:)

余分な

このコードは、#DDD トークを介して #microservices に結合されたフレームワークからのコードで示され、DDD y CQRS: Preguntas Frecuentes ビデオで疑問が解決されました。

CodelyTV Pro コースで使用されるもの:

• PHP の DDD
• アーキテクチュラ ヘキサゴナル
• CQRS: コマンドクエリの責任の分離
• マイクロサービスでの通信: イベント駆動型アーキテクチャ

忘れずにコースにアクセスしてください

• 暗号化されたコース