Singleton - один екземпляр

Патерн Singleton гарантує один екземпляр класу на весь застосунок. У Laravel замість класичного Singleton зі static-властивістю та приватним конструктором використовують контейнерний singleton: app()->singleton(...). Контейнер створює об'єкт один раз і повертає той самий екземпляр на всі залежності.

Чому контейнерний варіант кращий: класичний static намертво «зашиває» залежність, його важко підмінити у тестах і неможливо мати дві різні конфігурації. Контейнерний singleton зберігає всі переваги DI - його легко замокати через app()->instance(...) або swap().

Користь - економія ресурсів і єдиний централізований стан (реєстри, пул з'єднань, конфіг). Ризик - глобальний стан ускладнює тести, приховує залежності та може зберігати дані між запитами у воркерах (Octane!).

Використовуйте обережно, коли справді потрібна одна інстанція. Для більшості сервісів достатньо звичайного зв'язування - контейнер і так передасть потрібну залежність через конструктор.

Коли НЕ варто: якщо клас тримає стан, прив'язаний до конкретного запиту чи користувача - singleton у довгоживучому процесі (Octane, queue worker) призведе до витоку даних між запитами.

class CurrencyRegistry
{
  private array $rates = [];

  public function set(string $code, float $rate): void
  {
    $this->rates[$code] = $rate;
  }

  public function get(string $code): float
  {
    return $this->rates[$code] ?? 1.0;
  }
}

app()->singleton(CurrencyRegistry::class);