mkijak/cronjob-commands-bundle

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

1.5 2022-03-13 02:21 UTC

This package is auto-updated.

Last update: 2024-03-12 14:29:15 UTC


README

Using this bundle you can manage cron jobs with yaml configuration of your Symfony application.

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

Installing

Update composer.json:

composer require mkijak/cronjob-commands-bundle

Enable the bundle in Symfony application:

# 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).

# 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"

Usage

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

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

* * * * * /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):

use Symfony\Component\Console\Output\OutputInterface;

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

Requirements

  • PHP 7.1 or above
  • Symfony 4.0 or newer

Licence

Symfony commands as cron jobs is licenced under the MIT Licence.