Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Manage all your cron jobs without modifying crontab. Handles locking, logging, error emails, and more.
Branch: master
Pull request Compare This branch is 89 commits behind hellogerard:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
resources
src/Jobby
tests/Jobby
.gitignore
.travis.yml
LICENSE
README.md
composer.json
composer.lock
phpunit.xml

README.md

Build Status

Jobby is a PHP cron job manager. Install the master jobby cron job, and it will manage all your offline tasks. Add jobs without modifying crontab. Jobby can handle logging, locking, error emails and more.

Install

  1. Install composer.
  2. Add jobby to your composer.json.

    'hellogerard/jobby': 'dev-master'

  3. Run composer install.

  4. Add the following line to your (or whomever's) crontab:

    * * * * * cd /path/to/project && php jobby.php 1>> /dev/null 2>&1

After jobby installs, you can copy an example jobby file to the project root.

% cp vendor/hellogerard/jobby/resources/jobby.php .

Usage

Features

  • Maintain one master crontab job.
  • Jobs run via PHP, so you can run them under any programmatic conditions.
  • Use ordinary crontab schedule syntax (powered by the excellent cron-expression).
  • Run only one copy of a job at a given time.
  • Send email whenever a job exits with an error status.
  • Run job as another user, if crontab user has sudo privileges.
  • Run only on certain hostnames (handy in webfarms).
  • Theoretical Windows support (but not ever tested)

Currently Supported Options

Global options can be given to the Jobby object constructor. These will be used as a default for all subsequent jobs. Individual jobs can override a particular option when the job is added.

Option       | Default                             | Required | Description
=============+=====================================+==========+============
             |                                     |          |
recipients   | null                                | No       | Comma-separated string of email addresses
mailer       | sendmail                            | No       | Email method: sendmail or smtp
smtpHost     | null                                | No       | SMTP host, if `mailer` is smtp
smtpPort     | 25                                  | No       | SMTP port, if `mailer` is smtp
smtpUsername | null                                | No       | SMTP user, if `mailer` is smtp
smtpPassword | null                                | No       | SMTP password, if `mailer` is smtp
runAs        | null                                | No       | Run as this user, if crontab user has `sudo` privileges
environment  | null or `getenv('APPLICATION_ENV')` | No       | Development environment for this job
runOnHost    | `gethostname()`                     | No       | Run jobs only on this hostname
output       | /dev/null                           | No       | Redirect `stdout` and `stderr` to this file
dateFormat   | 'Y-m-d H:i:s'                       | No       | Format for dates on `jobby` log messages
enabled      | true                                | No       | Run this job at scheduled times
debug        | false                               | No       | Send `jobby` internal messages to 'debug.log'
command      | none                                | Yes      | The job to run (either a shell command or anonymous PHP function)
schedule     | none                                | Yes      | Crontab schedule format (`man -s 5 crontab`)

Example jobby.php File

<?php 

require(__DIR__ . '/vendor/autoload.php');

$jobby = new \Jobby\Jobby();

// Every job has a name
$jobby->add('CommandExample', array(
    // Commands are either shell commands or anonymous functions
    'command' => 'ls',

    // Ordinary crontab schedule format is supported. This schedule runs every
    // hour
    'schedule' => '0 * * * *',

    // Stdout and stderr is sent to the specified file
    'output' => 'logs/command.log',

    // You can turn off a job by setting 'enabled' to false
    'enabled' => true,
));

$jobby->add('ClosureExample', array(
    // Commands can be PHP closures
    'command' => function() {
        echo "I'm a function!\n";
    },

    // This function will run every other hour
    'schedule' => '0 */2 * * *',

    'output' => 'logs/closure.log',
    'enabled' => true,
));

$jobby->run();

Credits

Developed before, but since inspired by whenever.

Something went wrong with that request. Please try again.