PHPackages                             fernleafsystems/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. [CLI & Console](/categories/cli)
4. /
5. fernleafsystems/jobby

ActiveLibrary[CLI & Console](/categories/cli)

fernleafsystems/jobby
=====================

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

4.0.0(3mo ago)048MITPHPPHP ^8.3CI passing

Since Oct 9Pushed 3mo agoCompare

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

READMEChangelogDependencies (7)Versions (39)Used By (0)

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

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

[![MIT License](https://camo.githubusercontent.com/f90fa13925f6cad8ef712f61a6d99d2984a4b5e0406000c79f2cbd32b7503380/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6665726e6c65616673797374656d732f6a6f6262792e737667)](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.

About This Fork
---------------

[](#about-this-fork)

This is a maintained fork of [hellogerard/jobby](https://github.com/jobbyphp/jobby), updated for modern PHP.

**Key changes:**

- PHP 8.3+ required
- Replaced abandoned SwiftMailer with Symfony Mailer
- Symfony 6.4/7.x/8.x components
- Abstracted mailer behind `MailerInterface` for custom implementations

See [CHANGELOG.md](CHANGELOG.md) for version history and [UPGRADE-4.0.md](UPGRADE-4.0.md) for breaking changes.

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

[](#requirements)

- PHP 8.3 or higher
- Symfony 6.4, 7.x, or 8.x (Symfony 8.x requires PHP 8.4+)

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)

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

[](#getting-started)

### Installation

[](#installation)

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

```
$ composer require fernleafsystems/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/fernleafsystems/jobby/resources/jobby.php .

```

### Running a job

[](#running-a-job)

```