---
title: "Builder - поетапна побудова об'єктів"
url: https://laravelukraine.com/blog/builder-poetapna-pobudova-objektiv
date: 2026-06-04
---

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

Builder збирає складний об'єкт поетапно, крок за кроком, замість того щоб передавати все одразу у конструктор.

### Яку проблему вирішує

Коли об'єкт має багато опцій, конструктор розростається до десятка аргументів, половина з яких опціональні. Виклик `new Report('Sales', $rows, true, false, null, ...)` стає нечитабельним, а порядок аргументів - джерелом помилок.

### Як вирішує

Окремий білдер тримає проміжний стан і надає fluent-методи для кожної опції. Кожен метод повертає `$this`, тож виклики ланцюжаться, а фінальний `build()` збирає готовий об'єкт. Читач бачить, що саме налаштовується, бо кожен крок має ім'я.

```php
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();
```

### Де застосовувати

- Складні об'єкти з багатьма опціями: запити, PDF, email, об'ємні DTO.
- Коли потрібно зручно створювати різні конфігурації одного об'єкта.
- У самому Laravel ідея Builder всюди: `Query Builder`, `Mail`, `Notification`, `Http` - це ланцюжки методів, що поетапно конфігурують об'єкт перед виконанням.

### Плюси та мінуси

- **+** Прибирає довгі конструктори, код виклику стає самодокументованим.
- **+** Дозволяє валідувати чи нормалізувати дані всередині `build()`.
- **−** Додатковий клас на кожен об'єкт.
- **−** Надлишковий для об'єкта з двома-трьома полями: звичайний конструктор або іменовані аргументи PHP 8 (`new Report(title: 'Sales')`) зрозуміліші за окремий білдер.