orisai/nette-scheduler – planning crontab jobs within php application

Marek Bartoš
Nette Blogger | 1069

Just released new Orisai library, orisai/nette-scheduler.


  • One line setup in crontab. If you have multiple vendor modules, multiple app run environments and multiple apps, tracking all the cron jobs can get quite hard. Instead we can manage all crontab jobs inside the app. And list them with scheduler:list command, including next running times.
  • Easy development. Instead of setting up crontab locally, just run scheduler:worker. Or run individual job with scheduler:run-job <id>
  • Locking. If job takes too long to complete, it can overlap with the next run. Better not let big data transformations run twice at the same time. While regular crontab is possible to setup with locking, it is not so easily available. Also these locks usually don't work well with complex environments.
  • Run evidence. With before/after events, we can easily track run times of every job and how often they fail or are skipped due to being locked.

Why not other libs?

  • They don't implement all features provided by native crontab. Parallelism for fast and in-time execution. Error handling and job isolation – jobs should not interact directly or indirectly in any way. Proper cron expression evaluation.
  • Well, one does it all. It is called crunz. But being a separate application, it is harder to configure. And is missing a worker command.

So, how to install scheduler?

  1. Install – composer require orisai/nette-scheduler
  2. Register extension
    	orisai.scheduler: OriNette\Scheduler\DI\SchedulerExtension
  3. Add your jobs
    			expression: * * * * *
    			callback: [@example.job.service, 'run']
  4. Configure crontab – * * * * * cd path/to/project && php bin/console scheduler:run >> /dev/null 2>&1

    Or run scheduler:worker (on your local machine)

Check the docs, this was just a brief overview

If you want to use it even in applications without Nette, it is built on top of orisai/scheduler

(It was really helpful to have orisai/clock during development. Testing crontab execution times is painful without frozen clock.)

Last edited by Marek Bartoš (2023-03-23 04:47)