PHP聚合根管理实体一致性吗

本文目录导读：

1. 为什么聚合根能管理实体一致性？
2. 一个具体的例子：订单（Order）聚合
3. 需要注意的关键点

是的，在领域驱动设计（DDD）中，聚合根（Aggregate Root）的核心职责之一就是管理其内部所有实体的一致性和业务不变量。

聚合根是确保数据一致性的“边界”和“守护者”。

下面详细解释这个机制：

为什么聚合根能管理实体一致性？

1. 所有权与边界：

   • 聚合根拥有对聚合内所有实体（Entity）和值对象（Value Object）的引用。
   • 外部对象（如其他聚合根或应用程序服务）不能直接修改聚合内的子实体,它们只能通过调用聚合根暴露的方法来间接操作。

2. 单一入口点：

   • 所有对聚合状态的变更，都必须通过聚合根的方法（如 changeOrderItemQuantity()、addAddress()）。
   • 这确保了聚合根在执行任何操作时，都能完全控制内部状态的变化,并在操作结束后检查并确保所有业务规则都得到满足。

3. 原子性操作：

   • 聚合根的方法通常代表一个完整的业务用例，在这个方法内部,可能会修改多个子实体和值对象的状态。
   • 数据库层面（会以整个聚合根为粒度进行持久化，确保这一系列操作要么全部成功，要么全部失败,从而保证事务性一致性。

一个具体的例子：订单（Order）聚合

假设一个 Order（订单）聚合，包含 OrderItem（订单项）实体和一个 Address（地址）值对象。

业务规则（不变量）：

• 一个订单的总金额必须大于0。
• 一个订单项的数量不能为负数。

不一致的“坏”做法（绕过聚合根）：

// 假设有人可以直接获取到 OrderItem 对象
$order = $orderRepository->find($orderId);
$items = $order->getItems(); // 假设返回了数组引用
// 直接修改子实体，绕过了 Order 聚合根
$items[0]->setQuantity(-5); // 违反了业务规则
// 订单的总金额计算可能没有更新
// Order 聚合内部处于不一致状态
$orderRepository->save($order); // 保存了一个错误的订单

一致的“好”做法（通过聚合根管理）：

// 在 Order 聚合根内定义方法
class Order {
    private array $items;
    private Money $totalAmount;
    public function changeItemQuantity(int $itemId, int $newQuantity): void {
        // 1. 验证新数量
        if ($newQuantity < 0) {
            throw new InvalidArgumentException("数量不能为负数");
        }
        // 2. 找到对应的订单项
        $item = $this->findItem($itemId);
        if (!$item) {
            throw new RuntimeException("订单项未找到");
        }
        // 3. 修改订单项的数量 (通过子实体的方法)
        $item->changeQuantity($newQuantity);
        // 4. 重新计算并更新订单总金额 (核心逻辑)
        $this->recalculateTotalAmount();
        // 5. Order 聚合内部始终一致：
        //    - 订单项数量 >= 0
        //    - 总金额 = 所有订单项金额之和
    }
    private function recalculateTotalAmount(): void {
        $total = new Money(0);
        foreach ($this->items as $item) {
            $total = $total->add($item->getSubtotal());
        }
        $this->totalAmount = $total;
    }
    // 注意：不应暴露 getItems() 或类似方法返回内部集合的引用
    // 如果需要公开数据，应返回只读的 DTO 或数组的副本
}

外部调用方（如控制器或服务）：

class OrderService {
    public function updateItemQuantity(int $orderId, int $itemId, int $newQty): void {
        $order = $this->orderRepository->find($orderId);
        // 调用聚合根的单一入口
        $order->changeItemQuantity($itemId, $newQty);
        $this->orderRepository->save($order); // 持久化整个聚合
    }
}

需要注意的关键点

1. 非万能保证：聚合根保证的是业务一致性和事务边界内的一致性，它无法处理最终一致性场景（如跨多个聚合或跨服务的操作），那是事件驱动架构（Eventual Consistency）的范畴。

2. 避免大聚合：如果聚合根太大（包含过多实体），可能会导致性能问题（每次都要加载和保存很多数据）和并发冲突增加,需要进行合理的聚合拆分。

3. 不要在聚合根外部持有内部实体引用：这是最容易破坏一致性的地方，如果外部代码直接持有 OrderItem 对象并修改它，聚合根将失去控制,通常的做法是：

   • 不公开 getItems() 这种返回可修改集合的方法。
   • 如果必须公开，返回只读的 array 或 Collection（如 Laravel Eloquent 的集合在序列化时是安全的，但直接修改属性风险仍在）。
   • 使用 Repository 模式，只通过 save(聚合根) 来持久化。

4. PHP 中的实现：在 PHP 中，使用面向对象特性即可实现，关键是设计好类的方法，确保修改内部状态的入口都在聚合根上，使用像 doctrine 这样的 ORM 可以利用其实体管理器的工作单元（Unit of Work）模式，自动追踪聚合内所有实体的变化并以原子方式提交,这大大简化了实现。

核心思想：把聚合根想象成一个“有权限的管家”，所有对房间（聚合）内物品（实体）的操作，都必须通过他来安排,他确保每次操作后房间都是整洁有序的。