Scheduler Module

Installation

composer require boehsermoe/luya-module-scheduler:"~1.0.0", _(*1)

In order to add the modules to your project go into the modules section of your config:, _(*2)

return [
    'modules' => [
        // ...
    'scheduleradmin' => [
            'class' => 'luya\scheduler\admin\Module',
        ],
        'scheduler' => [
            'class' => 'luya\scheduler\frontend\Module',
        'accessToken' => '{token for web access}' // optional for webcron
        ],
        // ...
    ],
];

```shell ./vendor/bin/luya migrate ./vendor/bin/luya import, _(*3)


Don`t forget to assign permission to user group for the scheduler module.

## Start jobs manuell via CLI

Start all expired jobs manual:
```shell
./luya scheduler/run

Execute specified job:, _(*4)

./luya scheduler/run/now {id/name of the job}

Trigger jobs by cron

Start all expired jobs every minute via cron:, _(*5)

* * * * * ./luya scheduler/run

Trigger jobs alternativ

Via Webcron

Call the route https://{Host}/scheduler/run?token={Access token from config} to start expired jobs. You can use this url for webcrons like https://cron-job.org/de/ or https://uptimerobot.com/. Or any other webcron service., _(*6)

Via yii application event

[
...
 'on afterRequest' => function() {
     if (!$this->isCli()) {
         Yii::$app->getModule('scheduler')->runExpiredJobsAsync();
     }
 },
...
]

CommandJob: Execute console commands

For example you can flush the cache every hour by add a new CommandJob (Scheduler -> CommandJobs -> Add) and insert "cache/flush-all" as command. The command is the route of the console command., _(*7)

commandjob-screen , _(*8)

Custom Jobs

You can also write your own jobs classes in the path "{appBasePath}/schedulers" or "{moduleBasePath}/schedulers". Every job have to inherite from BaseJob., _(*9)

class ExampleJob extends \luya\scheduler\models\BaseJob
{
    public function run()
    {
        // Do your job.
    }
}

A job with a text field as option could look like this:, _(*10)

class ExampleTextJob extends \luya\scheduler\models\BaseJob
{
    public $text;

    public function rules()
    {
        return array_merge(parent::rules(), [
            [['text'], 'required']
        ]);
    }

    public function extraFields()
    {
        return [
            'text'
        ];
    }

    public function ngrestExtraAttributeTypes()
    {
        return [
            'text' => 'text',
        ];
    }

    public function run()
    {
        // Do your job
    //
    // echo $this->text;
    }
}