proklung/task-scheduler-bundle

A task scheduler for custom Symfony using CRON jobs porting that allows you to run tasks periodically

1.0.0 2021-05-31 14:55 UTC

Requires

• php: >=7.3 | ^8.0
• dragonmantank/cron-expression: ^3.1
• psr/container: ^1.0
• symfony/config: ^4.4 || ^5.1
• symfony/console: ^4.4 || ^5.1
• symfony/dependency-injection: ^4.4 || ^5.1
• symfony/http-kernel: ^4.4 || ^5.0

Requires (Dev)

• proklung/phpunit-testing-tools: ^1.0

MIT

• Gavrilov Fedy

README

Форк пакета. Доработано под личные нужды.

Установка

composer.json:

    "repositories": [
        {
            "type": "git",
            "url": "https://github.com/proklung/task.scheduler.bundle"
        }
    ]

composer require proklung/task-scheduler-bundle

Оригинальная документация

Usage

First, add the following line to your CRON tabs : * * * * * php /path/to/your/project/bin/console ts:run >> /dev/null 2>&1

This will call the scheduler, which will review all scheduled tasks and dispatch accordingly. You can call a task directly by providing it's ID as a parameter to the command. Note that this ID is generated by the scheduler and is in no way related to the service itself.

The >> /dev/null 2>&1 option discards the printed results of the tasks. Removing it allows to send it by email instead. This may vary so please refer to your server's configuration.

You then need to create a task. Tasks can be any service! You just have to give it the ts.task tag and implement TaskInterface, or for simplicity extend from AbstractScheduledTask.

Every X Minutes

In Foo\Bar\Task to schedule a task every 5 minutes:

use Prokl\TaskSchedulerBundle\Task\AbstractScheduledTask;
use Prokl\TaskSchedulerBundle\Task\Schedule;

class Task extends AbstractScheduledTask {
  protected function initialize(Schedule $schedule) {
    $schedule
      ->everyMinutes(5); // Perform the task every 5 minutes
  }

  public function run() {
    // Do stuff
  }
}

Your task is now scheduled and will be called every 5 minutes.

Every X Hours or Daily

if you are scheduling your task on an hourly or daily basis, you'll need to set minutes() in addition to hours(), everyHours(), or daily(). If you omit minutes(), the task will run every minute on the scheduled hour(s).

In Foo\Bar\Task to schedule a task every 5 hours:

use Prokl\TaskSchedulerBundle\Task\AbstractScheduledTask;
use Prokl\TaskSchedulerBundle\Task\Schedule;

class Task extends AbstractScheduledTask {
  protected function initialize(Schedule $schedule) {
    $schedule
      ->minutes(0)
      ->everyHours(5); // Perform the task every 5 hours on minute 0
      
    // Or if you want to perform your task at midnight every day
    // $schedule->minutes(0)->hours(0)->daily();
    
    // Or schedule your task to run once at 9AM daily (this is effectively the same as daily() above)
    // $schedule->minutes(0)->hours(9);
  }

  public function run() {
    // Do stuff
  }
}