Builder - поетапна побудова об'єктів

Патерн Builder корисний, коли об'єкт має багато опцій і варіантів. Він дозволяє зібрати об'єкт поетапно і уникнути довгих конструкторів із десятком аргументів.

Це зручно для запитів, PDF, email або складних DTO. Builder також спрощує створення різних конфігурацій одного об'єкта і робить код виклику читабельним завдяки fluent-інтерфейсу.

Коли НЕ варто: якщо об'єкт має два-три поля, звичайний конструктор або іменовані аргументи PHP 8 (new Report(title: 'Sales')) зрозуміліші за окремий білдер. У самому Laravel ідея Builder всюди: Query Builder, Mail, Notification, Http - це ланцюжки методів, що поетапно конфігурують об'єкт перед виконанням.

class Report
{
  public function __construct(
    public string $title,
    public array $rows,
    public bool $withTotals,
  ) {}
}

class ReportBuilder
{
  private string $title = 'Report';
  private array $rows = [];
  private bool $withTotals = false;

  public function title(string $title): self
  {
    $this->title = $title;
    return $this;
  }

  public function rows(array $rows): self
  {
    $this->rows = $rows;
    return $this;
  }

  public function withTotals(bool $value = true): self
  {
    $this->withTotals = $value;
    return $this;
  }

  public function build(): Report
  {
    return new Report($this->title, $this->rows, $this->withTotals);
  }
}

$report = (new ReportBuilder())
  ->title('Sales')
  ->rows([['product' => 'Book', 'sum' => 100]])
  ->withTotals()
  ->build();