Команда schedule
Задачи по расписанию не перечислены в одном файле — они разбросаны атрибутами
#[Scheduled] по коду. Команда schedule собирает их в
таблицу, показывает расписание каждой и управляет самим планировщиком.
Что запланировано
Действие по умолчанию — именно список, поэтому команду можно вызвать без аргументов:
php call schedule
php call schedule list | [================================ 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().
Запуск планировщика
php call schedule start # в терминале
php call schedule start -d # в фоне
php call schedule stop # корректная остановка
php call schedule restart # остановить и сразу запустить сноваПланировщик — один долгоживущий процесс, который следит за временем и запускает задачи по мере наступления сроков. Сами задачи он выполняет отдельно, поэтому долгая задача не сдвигает расписание остальных.
Планировщик один на хост
Второй запуск не создаст второй планировщик: класс защищён блокировкой, как и любой процесс-одиночка. Это защита от двойного срабатывания — иначе после неудачной выкладки или перезапуска задачи выполнялись бы по два раза.
Из этого же следует, что на нескольких серверах планировщик должен работать на одном. Приложение можно масштабировать, планировщик — нет.
Обычно отдельно его не запускают: атрибут #[EnableScheduler] на классе приложения
поднимает планировщик вместе с call run. Отдельный запуск нужен, когда планировщик
живёт своим процессом — в своём контейнере или под супервизором.
Состояние
php call schedule status | [================================ 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 — планировщик
ждёт следующего срока; это нормальное состояние почти всё время.
Если планировщик остановлен, команда скажет прямо:
| [ Scheduler Status ]
| Scheduler ................................................... [○ STOPPED]
| [i] The scheduler is not running.Ресурсы планировщика
php call schedule status -vФлаг дописывает блок [ Resources ] — пользователь, PID родителя, CPU, память и время
работы процесса планировщика по данным операционной системы:
| - - - - - - - - - - - - - - - - - - - - - - -
| [ 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]) — он запускается со своими параметрами. - Не объявлен — приложение его подхватывает: без повторов, некритичный, работает, пока его не остановят. Так его можно включить на пару дней и выключить, не трогая состав приложения.
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 — запуск планировщика вместе с приложением