PHPackages                             hatimox/jobby - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hatimox/jobby

ActiveLibrary[Utility & Helpers](/categories/utility)

hatimox/jobby
=============

Manage all your cron jobs without modifying crontab. Handles locking, logging, error emails, and more.

4.0.0(3mo ago)03.7k↓31.3%1MITPHPPHP >=8.0

Since Oct 9Pushed 3mo agoCompare

[ Source](https://github.com/hatimox/jobby)[ Packagist](https://packagist.org/packages/hatimox/jobby)[ Docs](https://github.com/hatimox/jobby)[ RSS](/packages/hatimox-jobby/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (9)Versions (47)Used By (0)

Jobby, a PHP cron job manager
=============================

[](#jobby-a-php-cron-job-manager)

[![Total Downloads](https://camo.githubusercontent.com/b471b1adde75819ae145b8623a9e2d32fdf8ad7e4944cfea13fa2c51c3c5a253/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686174696d6f782f6a6f6262792e737667)](https://packagist.org/packages/hatimox/jobby)[![Latest Version](https://camo.githubusercontent.com/a0b408a56c73c2d3d44b27e9b175540d572886f164ae7027ab907c9310f9178b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686174696d6f782f6a6f6262792e737667)](https://packagist.org/packages/hatimox/jobby)[![Build Status](https://camo.githubusercontent.com/2411c295006309088fba0014a9cd4faa13362dc7a5f8b2c9137575267a8ac986/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f686174696d6f782f6a6f6262792e737667)](https://travis-ci.org/hatimox/jobby)[![MIT License](https://camo.githubusercontent.com/abdb3657b60772508306cde5b8a92bd73c0d639d864914fcfdd1c18543e41656/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f686174696d6f782f6a6f6262792e737667)](https://github.com/hatimox/jobby/blob/master/LICENSE)

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.

Features
--------

[](#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`](https://github.com/dragonmantank/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)
- Send alerts to Slack or Mattermost whenever a job exits with an error status.

Requirements
------------

[](#requirements)

- PHP 8.0 or higher
- [Composer](http://getcomposer.org)
- `posix` extension (for Unix/Linux systems)

Getting Started
---------------

[](#getting-started)

### Installation

[](#installation)

The recommended way to install Jobby is through [Composer](http://getcomposer.org):

```
$ composer require hatimox/jobby

```

Then 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 file to the project root.

```
$ cp vendor/hatimox/jobby/resources/jobby.php .

```

### Running a job

[](#running-a-job)

```