Сервисы
Сервис — программа, без которой приложение не работает: база данных, кеш, файловый сервер. Вы объявляете его одной строкой, а приложение само запускает его, ждёт, пока он будет готов, и следит за ним.
Что такое сервис и зачем
Что это. Программа, которая работает рядом с вашим кодом, в том же контейнере. Например, PostgreSQL, к которому обращаются ваши репозитории.
Проблема. За такой программой нужно присматривать:
- запустить её раньше HTTP — иначе первые запросы придут, когда базы ещё нет;
- перезапустить, если она упала или зависла;
- остановить последней, когда HTTP уже не принимает запросов.
Писать это в каждом проекте вручную долго, и легко ошибиться.
Решение. Сервис сам знает, как запускать и проверять свою программу. Вам остаётся сказать приложению: «мне нужен вот этот сервис».
Как это выглядит
use Flytachi\Winter\Service\Postgres\Postgres;
protected static function components(Components $components): void
{
$components->service(new Postgres(database: 'app'));
}При старте приложения в логе:
Application starting High: postgres
postgres is up.
Application starting Normal: HttpСначала поднялся PostgreSQL, и только когда он ответил — HTTP.
Что приложение делает с сервисом
- Запускает раньше остальных и ждёт, пока он будет готов.
- Следит, жив ли он: упавший или зависший — перезапускает.
- Останавливает последним, после HTTP и процессов.
- Показывает в
call application statusрядом с остальными компонентами — и учитывает вcall app health, проверке здоровья контейнера: упавшая база делает егоunhealthy.
Сервис — такой же компонент, как HTTP или процесс, только описанный заранее и упакованный в класс.
Откуда берутся сервисы
- Готовые пакеты: PostgreSQL,
MariaDB, Redis —
composer requireи одна строка вcomponents(). - Свои. Сервис — обычный класс с двумя методами. Как его написать — на следующей странице.
Дальше
- Свой сервис — пишем простой сервис с нуля.
- Что нужно в образе — когда программы в образе нет.
- PostgreSQL, MariaDB, Redis — готовые пакеты.