CLI · Winter Console

Команда schedule

Задачи по расписанию не перечислены в одном файле — они разбросаны атрибутами #[Scheduled] по коду. Команда schedule собирает их в таблицу, показывает расписание каждой и управляет самим планировщиком.

По умолчанию listПланировщик один на хост

Что запланировано

Действие по умолчанию — именно список, поэтому команду можно вызвать без аргументов:

bash
php call schedule
php call schedule list
text
 | [================================ Schedule ================================]
| [ Scheduled Tasks ]
|	   TASK                                           TRIGGER
|	   Main\Task\Digest::sendDaily                    cron 0 9 * * *
|	   Main\Task\Cleanup::purgeTemp                   fixedRate 3600s
|	   Main\Task\Sync::pullRates                      fixedDelay 300s
| - - - - - - - - - - - - - - - - - - - - - - -
| [i] 3 task(s) defined.
| [ Scheduled Tasks ]
| [================================ Schedule ================================]

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

Триггер Что означает
cron 0 9 * * * По календарю — пять полей, без секунд
fixedRate 3600s Каждый час от начала предыдущего запуска
fixedDelay 300s Через пять минут после завершения предыдущего

Разница между двумя последними существенна: fixedRate держит частоту, fixedDelay держит паузу. Подробно — на странице Планировщик.

Когда список доступен

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

Свой планировщик с переопределённым discover() (задачи из базы и т.п.) консоль видит, только пока он запущен: без запуска она выводит The tasks of … come from its discover().

Запуск планировщика

bash
php call schedule start        # в терминале
php call schedule start -d     # в фоне
php call schedule stop         # корректная остановка
php call schedule restart      # остановить и сразу запустить снова

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

Планировщик один на хост

Второй запуск не создаст второй планировщик: класс защищён блокировкой, как и любой процесс-одиночка. Это защита от двойного срабатывания — иначе после неудачной выкладки или перезапуска задачи выполнялись бы по два раза.

Из этого же следует, что на нескольких серверах планировщик должен работать на одном. Приложение можно масштабировать, планировщик — нет.

Обычно отдельно его не запускают: атрибут #[EnableScheduler] на классе приложения поднимает планировщик вместе с call run. Отдельный запуск нужен, когда планировщик живёт своим процессом — в своём контейнере или под супервизором.

Состояние

bash
php call schedule status
text
 | [================================ Schedule ================================]
| [ Scheduler Status ]
|	 Scheduler ................................................... [Scheduler ● RUNNING]
| - - - - - - - - - - - - - - - - - - - - - - -
|	 PID          52190
|	 State        RUNNING
|	 Activity     IDLE
|	 Started      2026-08-14 06:40:12 +00:00
|	 Uptime       7h 55m
|	 Tasks        3
| [ Scheduler Status ]
| [================================ Schedule ================================]

Activity показывает, выполняется ли сейчас какая-то задача. IDLE — планировщик ждёт следующего срока; это нормальное состояние почти всё время.

Если планировщик остановлен, команда скажет прямо:

text
 | [ Scheduler Status ]
|	 Scheduler ................................................... [○ STOPPED]
| [i] The scheduler is not running.

Ресурсы планировщика

bash
php call schedule status -v

Флаг дописывает блок [ Resources ] — пользователь, PID родителя, CPU, память и время работы процесса планировщика по данным операционной системы:

text
 | - - - - - - - - - - - - - - - - - - - - - - -
| [ Resources ]
|	 User         winter
|	 PPID         1
|	 CPU          0.1 %
|	 Memory       0.4 % (28.6 MB)
|	 Elapsed      07:55:12

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

Пока работает приложение, планировщик запускает оно, а не консоль: start с -d и без одинаково просит приложение его запустить, и команда сразу возвращает управление. stop и restart тоже идут через приложение: остановленный планировщик остаётся остановленным до следующего start, а restart приложение выполняет само — сбоем это не считается.

  • Планировщик объявлен (#[EnableScheduler]) — он запускается со своими параметрами.
  • Не объявлен — приложение его подхватывает: без повторов, некритичный, работает, пока его не остановят. Так его можно включить на пару дней и выключить, не трогая состав приложения.
bash
php call schedule start     # приложение подхватывает планировщик
php call app status           # он в списке «Adopted»
php call schedule stop        # и приложение о нём забывает

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

Все действия

Команда Что делает
list Все задачи и их расписание (по умолчанию)
start Запуск в терминале
start -d Запуск в фоне
stop Корректная остановка (SIGTERM)
restart Остановить и сразу запустить снова
status Состояние, PID, время работы, число задач
status -v Дополнительно CPU и память процесса планировщика

Дальше

  • Планировщик — #[Scheduled], cron, fixedRate и fixedDelay
  • process — одиночные процессы
  • daemon — демоны и флоты воркеров
  • run — запуск планировщика вместе с приложением