php ddd example

Arsitektur Heksagonal, DDD & CQRS di PHP

Contoh aplikasi PHP yang menggunakan prinsip Domain-Driven Design (DDD) dan Command Query Responsibility Segregation (CQRS) yang menjaga kode sesederhana mungkin.

Lihatlah, mainkan dan bersenang-senanglah dengan ini. Bintang dipersilakan

Lihat Demo · Laporkan bug · Minta fitur

Pengaturan Lingkungan

Alat yang dibutuhkan

1. Instal Docker
2. Kloning proyek ini: git clone https://github.com/CodelyTV/php-ddd-example php-ddd-example
3. Pindah ke folder proyek: cd php-ddd-example

Konfigurasi lingkungan

1. Buat file lingkungan lokal ( cp .env .env.local ) jika Anda ingin mengubah parameter apa pun

Eksekusi aplikasi

1. Instal semua dependensi dan jalankan proyek dengan eksekusi Docker: make build
2. Maka Anda akan memiliki 3 aplikasi yang tersedia (2 API dan 1 Frontend):
   1. Bagian Belakang Mooc: http://localhost:8030/health-check
   2. Backend Backoffice: http://localhost:8040/health-check
   3. Bagian Depan Backoffice: http://localhost:8041/health-check

Eksekusi tes

1. Instal dependensi jika Anda belum pernah melakukannya: make deps
2. Jalankan tes PHPUnit dan Behat: make test

‍ Penjelasan proyek

Proyek ini mencoba menjadi platform MOOC (Massive Open Online Course). Ini dipisahkan dari kerangka apa pun, tetapi memiliki beberapa implementasi Symfony dan Laravel.

Konteks yang Dibatasi

• Mooc: Tempat untuk mencari jika Anda ingin melihat beberapa kode. Platform publik Kursus Online Terbuka Masif dengan pengguna, video, notifikasi, dan sebagainya.
• Backoffice: Di sini Anda akan menemukan kasus penggunaan yang diperlukan oleh departemen Dukungan Pelanggan untuk mengelola pengguna, kursus, video, dan sebagainya.

Arsitektur Heksagonal

Repositori ini mengikuti pola Arsitektur Heksagonal. Selain itu, ini disusun menggunakan modules . Dengan ini, kita dapat melihat bahwa struktur Konteks Terikat saat ini adalah:

$ 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 

Pola repositori

Repositori kami berusaha sesederhana mungkin biasanya hanya berisi 2 metode search dan save . Jika kita memerlukan beberapa kueri dengan lebih banyak filter, kita menggunakan pola Specification yang juga dikenal sebagai pola Criteria . Jadi kami menambahkan metode searchByCriteria .

Anda dapat melihat contohnya di sini dan implementasinya di sini.

Agregat

Anda dapat melihat contoh agregat di sini. Semua agregat harus memperluas AggregateRoot.

Bis Komando

Ada 1 implementasi bus perintah.

1. Sinkronisasi menggunakan Bus Pesan Symfony.

Bus Kueri

Bus Kueri menggunakan Bus Pesan Symfony.

Bus Acara

Bus Acara menggunakan Bus Pesan Symfony. Bus MySql menggunakan MySql+Pulling sebagai bus. Bus RabbitMQ menggunakan ekstensi RabbitMQ C.

Pemantauan

Setiap kali peristiwa domain dipublikasikan, peristiwa tersebut diekspor ke Prometheus. Anda dapat mengakses panel Prometheus di sini.

Berkontribusi

Ada beberapa hal yang hilang (tambahkan kesombongan, perbaiki dokumentasi...), silakan tambahkan ini jika Anda mau! Jika Anda ingin beberapa pedoman jangan ragu untuk menghubungi kami :)

Tambahan

Kode ini ditampilkan dalam kode Dari kerangka kerja yang digabungkan ke #layanan mikro melalui pembicaraan #DDD dan keraguan yang dijawab dalam video DDD y CQRS: Preguntas Frecuentes.

Digunakan dalam kursus CodelyTV Pro:

• DDD di PHP
• Arsitektur Heksagonal
• CQRS: Pemisahan Tanggung Jawab Permintaan Perintah
• Komunikasi antara layanan mikro: Arsitektur Berbasis Peristiwa

ingatlah untuk mengunjungi kursus kami

• Kursus dengan kode