Search by

phpsoftbox / scheduler

inspector-who

Scheduler component for the PhpSoftBox framework

Package info

github.com/phpsoftbox/scheduler

pkg:composer/phpsoftbox/scheduler

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 134

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-09-29 10:26 UTC

Requires

Requires (Dev)

Suggests

  • ext-pcntl: Lets schedule:work stop gracefully on SIGTERM/SIGINT after the current tick.
  • ext-redis: Required by RedisScheduleLockStore for atomic distributed scheduler locks
  • phpsoftbox/cli-app: Required for schedule:run and schedule:work commands.
  • phpsoftbox/queue: Required for onQueue() tasks and SchedulerQueueJobHandler.

Provides

None

Conflicts

None

Replaces

None

MIT 051bf5fbfc26bbaf6639e1507483900fda22895c

  • Anton K. <inspector-who.woop@mail.ru>

Published on Packagist.org on 2026-09-29 10:34 UTC

This package is auto-updated.

Last update: 2026-09-29 11:56:09 UTC

README

About

phpsoftbox/scheduler — планировщик задач с cron-выражениями и удобным API для расписаний. Позволяет регистрировать задания и запускать их только в нужное время.

Ключевые свойства:

  • Scheduler для регистрации задач и запуска по расписанию
  • ScheduledTask для настройки расписаний
  • ScheduledGroup для групповых расписаний
  • CronExpression для проверки времени
  • поддержка DI для invokable-обработчиков
  • opt-in блокировки пересечений через withoutOverlapping()
  • атомарный onOneServer() для нескольких scheduler-реплик
  • подробный ScheduleResult и изоляция ошибок отдельных задач
  • PSR-20 clock для детерминированного времени
  • запуск CLI-команд через command()
  • опциональная интеграция с Queue

Quick Start

use DateTimeImmutable;
use PhpSoftBox\Scheduler\Scheduler;

$scheduler = new Scheduler();

$scheduler->run(function (DateTimeImmutable $time): void {
    // задача каждые 5 минут
})->every(5)->minutes();

$scheduler->dispatch(new DateTimeImmutable('now'));

Для production/HA передайте атомарный ScheduleLockStoreInterface. Обычный PSR-16 cache остаётся совместимым single-process fallback, но его контракт не позволяет гарантировать атомарность между репликами.

Оглавление