mkijak/cronjob-commands-bundle

Runs (or not) registered Symfony commands according to cron expressions

Symfony commands as cron jobs

Using this bundle you can manage cron jobs with yaml configuration of your Symfony application., _(*1)

It: * provides a simple way of running commands according to cron expressions * supports command arguments, options and verbosity settings * prints full output of running commands * uses https://github.com/dragonmantank/cron-expression to resolve cron expressions, _(*2)

Installing

Update composer.json:, _(*3)

composer require mkijak/cronjob-commands-bundle

Enable the bundle in Symfony application:, _(*4)

# config/bundles.php 

Mkijak\CronJobCommandsBundle\CronJobCommandsBundle::class => ['all' => true],

Configuration

It is recommended to set the timezone (default timezone is UTC and server settings aren't considered)., _(*5)

``` yaml, <sub>(*6)</sub>

config/packages/cron_job_commands.yaml

cron_job_commands: timezone: UTC schedule: command1: name: app:command #command name registered in symfony enabled: true #default: true cron_expression: "* * * * *" #supports also predefined keywords e. g. "@daily", see https://github.com/dragonmantank/cron-expression arguments: argument1name: value argument2name: value options: option1name: value option2name: value multivalue_options: option1name: - value1 - value2 option2name: - value1 command2: name: app:another_command cron_expression: "@daily", <sub>(*7)</sub>

Usage
==========================
Run the "trigger-command" once per minute. Consider using quiet mode for less output. 

For cron: add to crontab (`crontab -e`):

```bash
* * * * * /path/to/symfony/bin/console cron_commands:trigger -q

In the quiet mode you can still display some messages from your commands setting visibility level as a second parameter of the writeln function (or 3rd parameter of the write function):, <sub>(*8)</sub>

``` php use Symfony\Component\Console\Output\OutputInterface;, <sub>(*9)</sub>

/** @var OutputInterface $output */ $output->writeln('Message', OutputInterface::VERBOSITY_QUIET) ```, <sub>(*10)</sub>

Requirements

• PHP 8.0 or above
• Symfony 5.0 or newer

Licence

Symfony commands as cron jobs is licenced under the MIT Licence., <sub>(*11)</sub>