Команда process
Процессы можно запускать не только из кода. Команда process находит
все классы-процессы проекта, показывает, кто из них сейчас работает, и позволяет
запустить, остановить и осмотреть любой — не трогая приложение.
Зачем
Процесс — единица работы вне запроса: импорт, рассылка, пересчёт. Ему нужны операционные действия, которых нет в коде приложения: посмотреть, идёт ли он сейчас, запустить руками после сбоя, остановить перед выкладкой, разобраться, почему он ест процессор.
Команда process даёт ровно это. Что такое процессы и как их писать — на странице
Процессы.
Что есть в проекте
php call process list | [================================ 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:
php call process main.process.ImportProcess statusТочки заменяются на разделители пространств имён, а первая буква каждого сегмента
делается заглавной: main.process.ImportProcess → Main\Process\ImportProcess.
Остальные буквы команда не трогает, поэтому имя класса пишется в своём регистре:
main.process.importprocess превратится в Main\Process\Importprocess, и такого класса
команда не найдёт.
Запуск
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. Терминал можно закрыть.
[✓] Dispatched (background): Main\Process\Import
PID 48213Повторный запуск не создаёт второй процесс
Если процесс уже работает, команда об этом скажет и ничего не запустит:
[!] Already running [PID:48213] (2026-08-14 09:12:44).Это тот же механизм блокировки, что защищает процесс от параллельного запуска
изнутри приложения, — файл блокировки в .winter/runnable.
WebSocket: порт обязателен
WebSocket-сервер — тоже процесс, но без порта он не запустится. Порт и, при необходимости, интерфейс передаются опциями:
php call process main.ChatSocket start --port=8001
php call process main.ChatSocket start --port=8001 --host=127.0.0.1 -dБез --port команда ничего не запускает и подсказывает, что нужно:
[!] A WebSocket needs a port: --port=8001 [--host=0.0.0.0].Исключение — сокет, объявленный в составе приложения (#[EnableWebSocket]), пока это
приложение работает на этом же хосте: start без --port просит приложение запустить
его, и тот получает объявленный порт.
status и stop работают как у любого процесса — порт для них не нужен. А вот
restart сокета, запущенного самостоятельно, команда откажет: порт, с которым он был
запущен, здесь неизвестен, а останавливать то, что не получится запустить снова, она не
станет. Такой сокет перезапускают в два шага — stop, затем start --port=…. Сокет,
которым управляет работающее приложение, restart перезапускает обычным образом, с его
портом.
Остановка
php call process main.process.Import stopОтправляется SIGTERM — сигнал корректного завершения. Процесс получает
возможность доработать текущую итерацию, закрыть соединения и выйти сам. Немедленно
он не умирает, и это правильно: незавершённая запись в базу хуже задержки на
секунду.
Состояние
php call process main.process.Import status[ 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 добавляется потребление ресурсов, снятое у операционной системы:
php call process main.process.Import status -v[ Resources ]
User winter
PPID 1
CPU 12.4 %
Memory 3.1 % (248.6 MB)
Elapsed 02:14:31Это первое, куда стоит смотреть, когда процесс «висит»: Activity покажет, работает
он или простаивает, а CPU и Memory — во что упёрся.
При работающем приложении
Пока работает приложение, процесс запускает оно, а не
консоль: start с -d и без одинаково просит приложение запустить процесс, и команда
сразу возвращает управление.
| [ 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 в таком состоянии нет:
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 26srestart останавливает и сразу запускает снова; при работающем приложении — его руками,
сбоем это не считается.
Если приложение работает в другом окружении (в контейнере, а команда выполнена на хосте), команда откажет и подскажет выполнить её там. Подробнее — Управление работающим компонентом.
Все действия
| Команда | Что делает |
|---|---|
list |
Все процессы проекта с текущим состоянием |
<Класс> |
Запуск на переднем плане |
<Класс> start |
То же явно |
<Класс> start -d |
Запуск в фоне |
<Класс> stop |
Корректная остановка (SIGTERM) |
<Класс> restart |
Остановить и сразу запустить снова |
<Класс> status |
Состояние, PID, время работы |
<Класс> status -v |
Дополнительно потребление ресурсов |
<Сокет> start --port=N [--host=…] [-d] |
Запуск WebSocket-сервера — порт обязателен, кроме объявленного сокета при работающем приложении |