Composite - дерево об'єктів

Патерн Composite дозволяє працювати з деревом об'єктів так само, як з одним об'єктом. І окремий «лист», і «гілка» (група) реалізують той самий інтерфейс, тож клієнт викликає в них однакові методи.

Це корисно для ієрархічних структур: меню та підменю, дерева категорій, вкладені права доступу, кошик із бандлами, UI-компоненти.

Клієнтський код не відрізняє лист від групи - рекурсія обходу прихована в самих об'єктах. Таким чином, логіка стає простішою і однаковою для всіх рівнів вкладеності.

У прикладі нижче і окремий товар (ProductItem), і набір товарів (Bundle) вміють рахувати total(). Бандл рахує суму своїх дітей, які теж можуть бути бандлами - глибина дерева не обмежена.

Коли НЕ варто: якщо структура завжди пласка (немає вкладеності) - Composite надлишковий, вистачить звичайної колекції.

interface CartItem
{
  public function total(): int;
}

class ProductItem implements CartItem
{
  public function __construct(private int $price) {}

  public function total(): int
  {
    return $this->price;
  }
}

class Bundle implements CartItem
{
  private array $items = [];

  public function add(CartItem $item): void
  {
    $this->items[] = $item;
  }

  public function total(): int
  {
    return array_sum(array_map(
      fn (CartItem $item) => $item->total(),
      $this->items
    ));
  }
}