README

Recurring and delayed background jobs with lease-based workers, retry logic, and overlap protection.

Purpose

Manages scheduled job execution. Jobs are persisted via ORM, leased by workers with heartbeat monitoring, and retried with exponential backoff on failure. Cron expressions define recurring schedules.

Role in Semitexa

Depends on semitexa/core, semitexa/orm, and semitexa/tenancy. Uses dragonmantank/cron-expression for schedule parsing. Jobs execute within tenant context when tenancy is active.

Key Features

Cron-based recurring job scheduling
Lease-based worker execution with heartbeat
Exponential backoff retry via RetryScheduler
Overlap protection (one execution per schedule)
RunStatus state machine (pending, running, completed, failed)
Tenant-isolated job execution

Configuring a schedule per install

cronExpression accepts the framework's env::VAR::default form:

#[AsScheduledJob(key: 'cms.translate', cronExpression: 'env::CMS_TRANSLATE_CRON::*/5 * * * *')]

The attribute is the package's default; .env is the install's decision. Editing scheduler_schedule_definitions by hand is not an alternative — scheduler:plan rewrites every field of the row from the attribute on each tick (only enabled is yours to keep). An expression that does not parse is refused with a warning naming the job, and that job keeps its previous schedule while the rest plan normally.

Notes

The scheduler is designed for Swoole long-running processes. Workers maintain leases via heartbeat and release them on graceful shutdown.

semitexa / scheduler

Package info

Security

Statistics