Команда application
Приложение — это один процесс, который запускает все объявленные компоненты и следит
за ними. application управляет им как целым: запустить, остановить,
посмотреть, в каком состоянии каждый компонент и что вообще будет запущено.
Зачем
У запущенного приложения много процессов: HTTP-сервер со своими воркерами, процессы,
демоны, планировщик, внешние программы. Смотреть на них по одному — через
process, daemon и ps —
неудобно, а на вопрос «всё ли поднялось и что упало» ответ даёт только супервизор
приложения: он знает, какой компонент работает, какой ждёт повторной попытки, а какой
отказал и почему.
application спрашивает его. А до запуска — читает код и окружение и показывает, что
запустится и с какими настройками.
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, под полным именем: те же
режим разработки и опции.
php call application start
php call application start dev # с наблюдателем
php call application start --http.port=9000info
Что запустится вместе с приложением и с какой конфигурацией. Приложение для этого
запускать не нужно: команда читает атрибуты, хук components() и окружение.
[ 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
не показывается.
[ 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
другой машины здесь ничего не значит. Выполните команду там:
docker compose exec server php call app statushealth
Что это. Проверка здоровья приложения для контейнера: одна строка и код выхода —
0, если здорово, 1, если нет.
Проблема. status пишет таблицу для человека и всегда выходит с кодом 0. Docker,
Kubernetes и балансировщики читают только код выхода — по status они не отличат
работающее приложение от того, у которого упала база.
Решение. health отвечает на один вопрос — работает ли всё, на чём держится
приложение, — тем языком, который понимает проверка контейнера.
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
services:
server:
healthcheck:
test: ["CMD", "php", "call", "application", "health"]
interval: 30s
timeout: 5s
start_period: 60s
start_interval: 5s
retries: 3call 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 его процессу, — и ждёт, пока оно завершится. Компоненты
останавливаются корректно: демон, например, даёт воркерам доделать текущую работу.
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 — отдельные компоненты