CLI · Winter Console

Команда process

Процессы можно запускать не только из кода. Команда process находит все классы-процессы проекта, показывает, кто из них сейчас работает, и позволяет запустить, остановить и осмотреть любой — не трогая приложение.

Действия list · start · stop · restart · statusДемоны отдельной командой

Зачем

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

Команда process даёт ровно это. Что такое процессы и как их писать — на странице Процессы.

Что есть в проекте

bash
php call process list
text
 | [================================ Process ================================]
| [ Available Processes ]
|	 [P] Main.Process.ImportProcess ..................... [● RUNNING] [BUSY] 12s
|	 [P] Main.Process.ReportProcess ..................... [○ STOPPED]
|	 [P] Main.Process.CleanupProcess ................... [● RUNNING] [idle] 3h 4m
| - - - - - - - - - - - - - - - - - - - - - - -
| [i] 3 defined, 2 running.
| [ Available Processes ]
| [================================ Process ================================]

Список собирается сканированием проекта, поэтому регистрировать процессы нигде не нужно — достаточно, чтобы класс наследовал Process. Демоны в этот список не попадают: у них своя команда.

Обозначение Значение
● / ○ Работает / остановлен
[BUSY] Сейчас выполняет полезную работу
[idle] Запущен, но простаивает

Имя класса

Класс указывается точечной записью — тем же способом, что в make и script:

bash
php call process main.process.ImportProcess status

Точки заменяются на разделители пространств имён, а первая буква каждого сегмента делается заглавной: main.process.ImportProcess → Main\Process\ImportProcess. Остальные буквы команда не трогает, поэтому имя класса пишется в своём регистре: main.process.importprocess превратится в Main\Process\Importprocess, и такого класса команда не найдёт.

Запуск

bash
php call process main.process.Import              # foreground
php call process main.process.Import start        # то же самое
php call process main.process.Import start -d     # в фоне

На переднем плане — процесс занимает терминал, пишет в него и завершается сам. Так его удобно отлаживать: видно вывод, Ctrl+C останавливает.

В фоне (-d) — команда открепляет процесс и возвращает управление, напечатав PID. Терминал можно закрыть.

text
[✓] Dispatched (background): Main\Process\Import
  PID          48213

Повторный запуск не создаёт второй процесс

Если процесс уже работает, команда об этом скажет и ничего не запустит:

[!] Already running [PID:48213] (2026-08-14 09:12:44).

Это тот же механизм блокировки, что защищает процесс от параллельного запуска изнутри приложения, — файл блокировки в .winter/runnable.

WebSocket: порт обязателен

WebSocket-сервер — тоже процесс, но без порта он не запустится. Порт и, при необходимости, интерфейс передаются опциями:

bash
php call process main.ChatSocket start --port=8001
php call process main.ChatSocket start --port=8001 --host=127.0.0.1 -d

Без --port команда ничего не запускает и подсказывает, что нужно:

text
[!] A WebSocket needs a port: --port=8001 [--host=0.0.0.0].

Исключение — сокет, объявленный в составе приложения (#[EnableWebSocket]), пока это приложение работает на этом же хосте: start без --port просит приложение запустить его, и тот получает объявленный порт.

status и stop работают как у любого процесса — порт для них не нужен. А вот restart сокета, запущенного самостоятельно, команда откажет: порт, с которым он был запущен, здесь неизвестен, а останавливать то, что не получится запустить снова, она не станет. Такой сокет перезапускают в два шага — stop, затем start --port=…. Сокет, которым управляет работающее приложение, restart перезапускает обычным образом, с его портом.

Остановка

bash
php call process main.process.Import stop

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

Состояние

bash
php call process main.process.Import status
text
[ Process Status ]
main.process.Import        Process ● RUNNING
PID          48213
State        RUNNING
Activity     BUSY
Started      2026-08-14 09:12:44
Uptime       2h 14m
Concurrency  4

С флагом -v добавляется потребление ресурсов, снятое у операционной системы:

bash
php call process main.process.Import status -v
text
[ Resources ]
User         winter
PPID         1
CPU          12.4 %
Memory       3.1 % (248.6 MB)
Elapsed      02:14:31

Это первое, куда стоит смотреть, когда процесс «висит»: Activity покажет, работает он или простаивает, а CPU и Memory — во что упёрся.

При работающем приложении

Пока работает приложение, процесс запускает оно, а не консоль: start с -d и без одинаково просит приложение запустить процесс, и команда сразу возвращает управление.

text
 | [ Available Processes (application) ]
|	 [P] Main.Process.Import ..................... [● RUNNING] [idle] [boot] 2h 14m
|	 [P] Main.Process.Export ..................... [● RUNNING] [BUSY] [adopted] 3m
Метка Значение
(application) Приложение работает — запуском распоряжается оно
[boot] Объявлен в составе приложения — запускается со своими параметрами
[adopted] Не объявлен — приложение подхватило его на один запуск: без повторов, некритичный
○ STOPPED / ✕ FAILED Компонент приложения остановлен по запросу / не смог работать

У остановленного компонента status показывает, когда он остановлен и кем управляется; PID в таком состоянии нет:

text
  main.process.Import ............. [○ STOPPED]
PID          —
State        STOPPED — on request
Managed by   application [PID 1]
Stopped at   2026-10-27 09:08:31 +00:00
Down for     2m 26s

restart останавливает и сразу запускает снова; при работающем приложении — его руками, сбоем это не считается.

Если приложение работает в другом окружении (в контейнере, а команда выполнена на хосте), команда откажет и подскажет выполнить её там. Подробнее — Управление работающим компонентом.

Все действия

Команда Что делает
list Все процессы проекта с текущим состоянием
<Класс> Запуск на переднем плане
<Класс> start То же явно
<Класс> start -d Запуск в фоне
<Класс> stop Корректная остановка (SIGTERM)
<Класс> restart Остановить и сразу запустить снова
<Класс> status Состояние, PID, время работы
<Класс> status -v Дополнительно потребление ресурсов
<Сокет> start --port=N [--host=…] [-d] Запуск WebSocket-сервера — порт обязателен, кроме объявленного сокета при работающем приложении

Дальше

  • Процессы — как писать процессы
  • WebSocket — WebSocket-сервер как процесс
  • daemon — то же для демонов и их воркеров
  • schedule — задачи по расписанию
  • run — запуск процессов вместе с приложением