CLI · Winter Console

Команда application

Приложение — это один процесс, который запускает все объявленные компоненты и следит за ними. application управляет им как целым: запустить, остановить, посмотреть, в каком состоянии каждый компонент и что вообще будет запущено.

Синоним appДействия start · stop · status · health · info

Зачем

У запущенного приложения много процессов: HTTP-сервер со своими воркерами, процессы, демоны, планировщик, внешние программы. Смотреть на них по одному — через process, daemon и ps — неудобно, а на вопрос «всё ли поднялось и что упало» ответ даёт только супервизор приложения: он знает, какой компонент работает, какой ждёт повторной попытки, а какой отказал и почему.

application спрашивает его. А до запуска — читает код и окружение и показывает, что запустится и с какими настройками.

bash
php call application info     # что запустится
php call application start    # запустить (= call run)
php call application status   # как оно сейчас
php call application health   # здорово ли: одна строка и код выхода
php call application stop     # остановить

app — короткое имя: php call app status.

start

Запускает приложение и работает, пока его не остановят, — в терминале, не в фоне. Это та же команда, что run, под полным именем: те же режим разработки и опции.

bash
php call application start
php call application start dev           # с наблюдателем
php call application start --http.port=9000

info

Что запустится вместе с приложением и с какой конфигурацией. Приложение для этого запускать не нужно: команда читает атрибуты, хук components() и окружение.

text
[ Components ]
COMPONENT                      KIND       SOURCE               CRITICAL  RETRIES  START TIMEOUT
Http :8000                     Http       #[EnableHttp]        yes       3        60s
Chat :8001                     WebSocket  #[EnableWebSocket]   yes       3        60s
Orders                         Daemon     #[EnableDaemon]      yes       -        60s
Heartbeat                      Process    components()         no        3        60s
bridge                         Command    components()         yes       0        -
[i] 5 component(s) start with the application.
[ HTTP server ]
Address        http://0.0.0.0:8000  (#[EnableHttp])
Workers        4
Memory         256M
Timeout        30s per request
Profile        balance · 455 in flight · 910 connections · recycle at 149,130
TLS            off — plain HTTP (TLS at the proxy)
HTTP/2         off
Compression    br/gzip · level 1 · from 1K
[ Configuration ]
Async          off
Caching        enabled
Actuator       enabled · health
DEBUG          false
LOG_LEVEL      info
Колонка Что значит
SOURCE Где объявлен компонент: атрибут или хук components()
CRITICAL Остановит ли его отказ всё приложение
RETRIES Сколько раз его поднимут после падения; - — никогда (демоны и программы)
START TIMEOUT Сколько ждать готовности при старте

Смысл параметров — в разделе Супервизия. Блок HTTP server — настройки сервера так, как их соберёт запуск без опций: адрес из #[EnableHttp], остальное из переменных SERVER_*, и всё это — с поправками класса-конфигуратора. В скобках у адреса — откуда он: из атрибута или из конфигуратора (ServerConfigurer), если тот его поменял. В строке Actuator — эндпоинты, которые он открывает (expose), и отметка guarded, если задан middleware.

status

Состояние запущенного приложения: его процесс, и по каждому компоненту — что о нём последним сообщил супервизор. Компоненты в двух списках: Boot — объявленные, запущены вместе с приложением; Adopted — необъявленные, запущенные позже по запросу (call schedule start, dispatch()), см. Запуск необъявленного процесса. Пустой список Adopted не показывается.

text
[ Application Status ]
Application ...................................... [● RUNNING]
PID            1
Host           3f2a9c1d7e40
Started        2026-10-27 09:12:03 +00:00
Uptime         2h 14m
[ Boot — started with the application ]
COMPONENT                      KIND       STATE      PID      FOR        RESTARTS
Http                           Http       RUNNING    12       2h 14m     0
Orders                         Daemon     RUNNING    14       2h 14m     0
CacheWarmup                    Process    COMPLETED  -        2h 13m     0
Heartbeat                      Process    WAITING    -        3s         2/3
    next attempt in 1s
    exit code 255
bridge                         Command    FAILED     -        40m        0
    exit code 1
[ Adopted — started on request, run once ]
COMPONENT                      KIND       STATE      PID      FOR
Scheduler                      Scheduler  RUNNING    88       1d 4h
Состояние Что значит
STARTING Запущен, ждём готовности
RUNNING Работает
WAITING Упал и ждёт повторной попытки — или ждёт свой уровень запуска
HELD Его класс уже запущен вне приложения — ждём, пока тот процесс завершится
FAILED Отказал: не поднялся или исчерпал попытки
STOPPED Остановлен по запросу
COMPLETED Закончил свою работу сам

FOR — сколько компонент в текущем состоянии, RESTARTS — перезапуски за последние 30 минут из допустимых (у подхваченных колонки нет: их не перезапускают). Подхваченный компонент, который закончил работу или остановлен, из списка исчезает. Под строкой — причина последнего падения или отказа.

Если у компонентов задан приоритет, info и status показывают колонку PRIORITY, а у компонента, который при старте ждёт свой уровень, под строкой написано, чего он ждёт: waits for High to be ready или waits for onStarting. У внешней программы START TIMEOUT — -, пока у неё нет проверки готовности: она готова сразу после запуска.

Если приложение запущено в другом окружении с той же папкой проекта (и её .winter/) — например, в контейнере, а команда выполняется на хосте, — status скажет об этом: Runs on another host sharing this project folder (a container?) — ask it there. PID другой машины здесь ничего не значит. Выполните команду там:

bash
docker compose exec server php call app status

health

Что это. Проверка здоровья приложения для контейнера: одна строка и код выхода — 0, если здорово, 1, если нет.

Проблема. status пишет таблицу для человека и всегда выходит с кодом 0. Docker, Kubernetes и балансировщики читают только код выхода — по status они не отличат работающее приложение от того, у которого упала база.

Решение. health отвечает на один вопрос — работает ли всё, на чём держится приложение, — тем языком, который понимает проверка контейнера.

bash
php call app health
# healthy: 4 component(s) up
Что видит Код Строка
Все критичные компоненты работают (процесс, закончивший работу, и HELD тоже считаются) 0 healthy: 4 component(s) up
Некритичный компонент отказал, компонент остановлен по запросу 0 healthy, degraded: report failed
Критичный компонент ещё стартует или ждёт перезапуска 1 unhealthy: postgres restarting (1 of 3)
Супервизор молчит дольше 30 секунд 1 unhealthy: no report from the supervisor for 45s
Приложение не запущено 1 unhealthy: not running

Супервизор сообщает о себе каждые несколько секунд, даже когда ничего не меняется. Молчание дольше 30 секунд значит, что завис он сам, — хотя в последнем его сообщении все компоненты ещё работали. Подхваченные компоненты в счёт не идут: их запускают один раз. Здоровая строка уходит в stdout, нездоровая — в stderr.

health ничего не спрашивает по сети — читает то, что супервизор и так публикует, — поэтому работает в любом приложении, с HTTP или без, и отвечает за доли секунды.

В Docker

docker-compose.yml
services:
server:
  healthcheck:
    test: ["CMD", "php", "call", "application", "health"]
    interval: 30s
    timeout: 5s
    start_period: 60s
    start_interval: 5s
    retries: 3

call cfg docker пишет это в docker-compose.yml нового проекта сам.

  • start_period — льготное время после старта контейнера: неудачные проверки в нём не считаются, контейнер — starting. Первый старт создаёт данные баз и проводит миграции, а health всё это время честно отвечает «ещё не готово». Проверка прошла раньше — контейнер healthy сразу. 60 секунд — столько же, сколько у сервиса на готовность (startTimeout): не готовый за это время критичный сервис и так останавливает приложение.
  • start_interval — как часто проверять в льготное время: каждые 5 секунд, а не каждые 30. Обычный перезапуск становится healthy через ~5 секунд — раньше стартует то, что его ждёт (depends_on: condition: service_healthy), быстрее идёт обновление без простоя в Swarm. Нужны Docker Compose 2.20+ и Docker Engine 25+.
  • retries — сколько неудач подряд делают контейнер unhealthy. Перезапуск одного компонента супервизором длится секунды — до трёх неудач подряд он обычно не доходит.

Сама проверка в compose ничего не перезапускает: она даёт статус healthy/unhealthy, который читают depends_on: condition: service_healthy, Swarm, балансировщики и мониторинг. Компоненты внутри контейнера и так перезапускает супервизор.

HTTP — ещё и через actuator

health видит то, что знает супервизор: процесс HTTP жив и готов. Отвечают ли его воркеры, он не проверяет. Для этого — HTTP-проверка через #[EnableActuator]: curl -f localhost:8000/actuator/health. Обе проверки дополняют друг друга; в Kubernetes call app health подходит как exec-проба.

stop

Останавливает приложение тем же способом, что и Ctrl+C или остановка контейнера, — сигналом SIGTERM его процессу, — и ждёт, пока оно завершится. Компоненты останавливаются корректно: демон, например, даёт воркерам доделать текущую работу.

bash
php call application stop
php call application stop --timeout=120          # ждать дольше
php call application stop --timeout=30 --force   # не успело — SIGKILL
Опция Что задаёт По умолчанию
--timeout= Сколько секунд ждать остановки 60
--force По истечении — SIGKILL приложению и всем его компонентам выключено

Без --force команда по истечении времени только сообщает, что приложение ещё работает, — обычно какой-то компонент дорабатывает начатое.

Остановить отдельный компонент, не трогая остальные, — call process <Класс> stop или call daemon <Класс> stop: см. Управление работающим компонентом.

Дальше

  • run — запуск приложения, режим разработки, адрес и порт
  • Состав приложения — что объявляют #[Enable*] и components()
  • process и daemon — отдельные компоненты