Планировщик
Назначение и когда использовать
Schedule запускает повторяемые задачи на minute tick. Используйте для cleanup, sync и отчётов; тяжёлую работу передавайте в queue.
Регистрация
Зарегистрируйте Schedule в контейнере приложения и добавьте callbacks:
use Esora\Scheduler\Schedule;
$schedule = $app->get(Schedule::class);
$schedule->call(fn (): void => cleanup(), [])->daily();
$schedule->call(fn (int $id): void => syncReport($id), [42])
->hourly()
->when(fn (): bool => appIsReady());
$schedule->command('php bin/console reports:sync')->cron('*/5 * * * *');
call(Closure|callable|string $callback, array $parameters = []) возвращает Event; command(string $command) создаёт event через exec. Частоты: everyMinute(), hourly(), daily(), произвольный 5-part cron через cron(string), фильтр через when(Closure). Проверка — dueEvents(?DateTimeImmutable $currentTime = null), просмотр — getEvents().
Lifecycle и troubleshooting
Внешний cron или composer dev вызывает php bin/console schedule:run каждую минуту → Schedule выбирает due events → Event::run(). when() проверяется перед cron. Если ничего не выполняется, проверьте регистрацию Schedule, timezone/UTC и корректность пяти частей cron; команда без сервиса сообщает No Schedule service registered.