⚡ Esora Документация

Планировщик

Назначение и когда использовать

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.