Laravel 領域驅動設計 (DDD) 簡單指南

發佈於2024-11-08

A Simple Guide to Domain-Driven Design (DDD) in Laravel

您是否曾感觉到，随着 Laravel 项目的发展，事情开始变得有点失控？控制器变得臃肿，模型开始做太多事情，突然之间，你的代码库就像你几个月来一直想组织的抽屉一样。这就是 领域驱动设计 (DDD) 可以介入并让您的生活更轻松的地方。

DDD 是一种设计应用程序的方法，使其结构与您在现实世界中解决的问题紧密结合。随着项目的发展，它有助于使您的代码更清晰、更具可扩展性并且更易于管理。

在本指南中，我们将引导您了解 Laravel 中的 DDD 基础知识，解释如何实现它，并向您展示一些现实世界的示例。

什么是领域驱动设计（DDD）？

在深入了解 Laravel 细节之前，让我们先介绍一下 领域驱动设计 (DDD) 的全部内容。 DDD 是一种通过关注业务领域（您的软件正在解决的核心问题）来组织应用程序代码的方法。

您不是围绕控制器或模型等技术概念构建代码，而是围绕现实世界概念构建代码。这可能是订单、产品或客户等内容，具体取决于您的应用程序的用途。

简而言之，DDD 可帮助您构建反映现实世界流程的应用程序，使代码更易于理解和维护，尤其是随着代码的增长。

为什么在 Laravel 中使用 DDD？

如果您熟悉 Laravel 默认使用的 MVC（模型-视图-控制器）模式，您就会知道它对于大多数应用程序都很有效。但随着应用程序的扩展，MVC 模式可能会导致混乱的相互依赖的代码。 领域驱动设计通过使您的应用程序更容易扩展和维护来解决这个问题。

DDD 还将业务逻辑与基础设施代码分开。这意味着您的应用程序逻辑不会与数据库或 API 之类的东西绑定，从而使以后更容易更换技术。

DDD 的组成部分

要了解 DDD 的工作原理，您需要了解其关键组件。让我们来分解一下：

实体

实体是您的域中具有独特身份的对象。例如，订单是一个实体，因为每个订单都是唯一的。

// app/Domain/Order/Order.php
class Order {
    private $id;
    private $status;

    public function __construct($id, $status) {
        $this->id = $id;
        $this->status = $status;
    }

    // Getter and other business logic
}

值对象

A 值对象是一个没有标识的对象，但它代表一个概念。例如，Money 对象代表一个值，但不需要唯一的 ID。

// app/Domain/Order/Money.php
class Money {
    private $amount;
    private $currency;

    public function __construct($amount, $currency) {
        $this->amount = $amount;
        $this->currency = $currency;
    }

    public function getFormatted() {
        return "{$this->amount} {$this->currency}";
    }
}

存储库

A Repository 处理获取和持久化实体等域对象。存储库管理数据访问，而不是直接与数据库交互的域对象。

// app/Domain/Order/OrderRepositoryInterface.php
interface OrderRepositoryInterface {
    public function findById($id): ?Order;
    public function save(Order $order): void;
}

// app/Infrastructure/Order/EloquentOrderRepository.php
class EloquentOrderRepository implements OrderRepositoryInterface {
    public function findById($id): ?Order {
        // Fetch order using Eloquent
    }

    public function save(Order $order): void {
        // Save order using Eloquent
    }
}

服务

A Service 处理业务逻辑，例如创建订单或处理付款。您无需将此逻辑放入控制器中，而是将其封装在服务中。

// app/Domain/Order/CreateOrderService.php
class CreateOrderService {
    public function execute($data) {
        $order = new Order($data['id'], $data['status']);
        // Business logic for creating an order
    }
}

在 Laravel 中实现 DDD

现在您已经了解了关键组件，让我们通过一些实际示例来看看如何在 Laravel 中实现 DDD。

示例1：构建订单管理系统

假设您正在为电子商务网站构建订单管理系统。以下是 DDD 如何帮助您组织代码：

实体：您将有一个订单实体来代表每个订单，并具有 id 和 status 等属性。
值对象：您可以创建一个 Money 值对象来表示价格。
Repositories：您将创建一个 OrderRepository 来在数据库中获取和存储订单。
服务：CreateOrderService 将处理创建新订单的逻辑。

这是基本流程：

// app/Http/Controllers/OrderController.php
class OrderController {
    private $createOrderService;

    public function __construct(CreateOrderService $createOrderService) {
        $this->createOrderService = $createOrderService;
    }

    public function store(Request $request) {
        $this->createOrderService->execute($request->all());
        return response()->json(['message' => 'Order created!']);
    }
}

示例 2：管理用户订阅

假设您正在管理 SaaS 平台的用户订阅。使用 DDD，您可以创建：

代表每个用户订阅的订阅实体。
用于管理订阅周期的持续时间值对象。
处理数据访问的 SubscriptionRepository。
用于处理续订订阅等业务逻辑的 SubscriptionService。

以下是处理订阅续订的方法：

// app/Domain/Subscription/RenewSubscriptionService.php
class RenewSubscriptionService {
    private $subscriptionRepository;

    public function __construct(SubscriptionRepositoryInterface $subscriptionRepository) {
        $this->subscriptionRepository = $subscriptionRepository;
    }

    public function renew($subscriptionId) {
        $subscription = $this->subscriptionRepository->findById($subscriptionId);
        $subscription->renew();
        $this->subscriptionRepository->save($subscription);
    }
}