「ドメイン駆動設計入門」のLaravelによる実装例:Chapter 0-開発環境のセットアップ

本プロジェクトでは、成瀬允宣氏著の「ドメイン駆動設計入門」のLaravel 10を用いた実装例を示します。

当該書籍では、ドメイン駆動設計(Domain Driven Deplopment, DDD)を用いたWEBアプリケーションの開発例が示されており、素晴らしい著作であることは言うまでもありません。
しかしながら実装はC#で示されているため
、例えばPHPフレームワークの代表例であるLaravelなどでDDDによる実装を行いたい場合には、具体的な実装例が分かりづらくなってしまいます。

そこで本プロジェクトでは、「ドメイン駆動設計入門」のLaravelによる実装例を示すことで、Laravel開発者のDDD実装の手助けとなることを目指します。あくまでLaravelの実装例を示すことを目的としていますので、ドメイン駆動設計とは何かについては書籍をお読みください。

これが皆様の開発の手助けとなれば幸いです。ご意見等ございましたら、コメント欄やIssueでお伝えいただければと思います。

目次

Githubにソースコードはアップ済みです。

• Chapter 0: 開発環境のセットアップ -> ここ
• Chapter 1: ドメイン駆動設計とは -> 書籍をお読みください。
• Chapter 2: システム固有の値を表現する「値オブジェクト」
• Chapter 3: ライフサイクルのあるオブジェクト「エンティティ」
• Chapter 4: 不自然さを解決する「ドメインサービス」
• Chapter 5: データにまつわる処理を分離する「リポジトリ」
• Chapter 6: ユースケースを実現する「アプリケーションサービス」(TDD)
• Chapter 7: 柔軟性をもたらす依存関係のコントロール (TDD)
• Chapter 8: ソフトウェアシステムを組み立てる (TDD)
• Chapter 9: 複雑な生成処理を行う「ファクトリ」(TDD)
• Chapter 10: データの整合性を保つ (TDD)
• Chapter 11: アプリケーションを1から組み立てる (TDD)
• Chapter 12: ドメインのルールを守る「集約」(TDD)
• Chapter 13: 複雑な条件を表現する「仕様」(TDD)
• Chapter 14: アーキテクチャ (TDD)
• Chapter 15: ドメイン駆動設計のとびらを開こう (TDD)

前提条件

本プロジェクトでは、Docker上で作業を行います(Dockerの知識は必要ありません)。
Docker上で作業する際、Visual Studio CodeのDev Containers 拡張機能を使用すると開発が便利になりますので、
Visual Studio Codeと拡張機能のインストールを推奨します。

また、PHPとPHPのパッケージマネージャーであるComposerをローカルマシンにインストールしておく必要があります。

Chapter 0: Laravel及びDocker環境のセットアップ

まずは、LaravelとDockerの開発環境を構築していきましょう。

以下でlaravel v10.0のプロジェクトをsrcフォルダ内に作成します。

composer create-project laravel/laravel src 10.0 --prefer-dist

srcフォルダに移動し、sailをインストールします。
これにより、Docker上での作業を行うとができます。
また、php artisan sail:install --devcontainerで--devcontainerオプションをつけることにより、
Visual Studio CodeのDev Containersの設定フォルダがsrc/.devcontainerに作成されます。
これにより、開発がかなり便利になります。

cd src
composer require laravel/sail --dev
php artisan sail:install --devcontainer

rootディレクトリに戻り、srcディレクトリをVisual Studio Codeで開き直します。

cd ..
code src

Visual Studio CodeのCommand Paletteを開き、Dev Containers: Reopen in Containerをクリックすると、Docker上でコードの編集を行うことができます。

以下でサーバーを立ち上げます。

php artisan serve

表示されたlocalhostのURLをブラウザで立ち上げ、Laravelのページが表示されていれば、セットアップ完了です。

INFO  Server running on [http://127.0.0.1:8000].