Сервисы

Сервисы

Сервис — программа, без которой приложение не работает: база данных, кеш, файловый сервер. Вы объявляете его одной строкой, а приложение само запускает его, ждёт, пока он будет готов, и следит за ним.

Объявление $components->service()Контракт Service

Что такое сервис и зачем

Что это. Программа, которая работает рядом с вашим кодом, в том же контейнере. Например, PostgreSQL, к которому обращаются ваши репозитории.

Проблема. За такой программой нужно присматривать:

  • запустить её раньше HTTP — иначе первые запросы придут, когда базы ещё нет;
  • перезапустить, если она упала или зависла;
  • остановить последней, когда HTTP уже не принимает запросов.

Писать это в каждом проекте вручную долго, и легко ошибиться.

Решение. Сервис сам знает, как запускать и проверять свою программу. Вам остаётся сказать приложению: «мне нужен вот этот сервис».

Как это выглядит

bootstrap.php
use Flytachi\Winter\Service\Postgres\Postgres;

protected static function components(Components $components): void
{
  $components->service(new Postgres(database: 'app'));
}

При старте приложения в логе:

text
Application starting High: postgres
postgres is up.
Application starting Normal: Http

Сначала поднялся PostgreSQL, и только когда он ответил — HTTP.

Что приложение делает с сервисом

  • Запускает раньше остальных и ждёт, пока он будет готов.
  • Следит, жив ли он: упавший или зависший — перезапускает.
  • Останавливает последним, после HTTP и процессов.
  • Показывает в call application status рядом с остальными компонентами — и учитывает в call app health, проверке здоровья контейнера: упавшая база делает его unhealthy.

Сервис — такой же компонент, как HTTP или процесс, только описанный заранее и упакованный в класс.

Откуда берутся сервисы

Дальше