PHPackages                             helthe/chronos - 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. helthe/chronos

ActiveLibrary

helthe/chronos
==============

Chronos: An object oriented cron job library

1.0.0(12y ago)2813MITPHPPHP >=5.3.3

Since Jun 13Pushed 11y ago1 watchersCompare

[ Source](https://github.com/helthe/Chronos)[ Packagist](https://packagist.org/packages/helthe/chronos)[ Docs](https://helthe.co)[ RSS](/packages/helthe-chronos/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Chronos [![Build Status](https://camo.githubusercontent.com/b0c23d761651e0b3932d722d9cff46fb98d3dbd65bbec13dcf7c15c703da4cf0/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f68656c7468652f4368726f6e6f732e706e673f6272616e63683d6d6173746572)](http://travis-ci.org/helthe/Chronos) [![Scrutinizer Quality Score](https://camo.githubusercontent.com/bbbd0e8b858c2f44c5a396cd1b9ad652bc36831cebcc39938f18848ae5770a40/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f68656c7468652f4368726f6e6f732f6261646765732f7175616c6974792d73636f72652e706e673f733d39393235356435376333396634333737353734633738323063316138643336613332623965653336)](https://scrutinizer-ci.com/g/helthe/Chronos/)
===============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#chronos--)

Chronos provides an object oriented library for managing cron jobs both with crontab and programmatically.

Installation
------------

[](#installation)

Add the following in your componser.json:

```
{
    "require": {
        "helthe/chronos": "~1.0"
    }
}
```

Usage
-----

[](#usage)

### CRON expression

[](#cron-expression)

At its core, Chronos uses a CRON expression parser to validate all cron jobs. It supports all the language characteristics defined [here](http://en.wikipedia.org/wiki/Cron#CRON_expression) as well as the [predefined scheduling definitions](http://en.wikipedia.org/wiki/Cron#Predefined_scheduling_definitions) except `@reboot`.

### Crontab

[](#crontab)

You can use the library to both deploy cron jobs directly into crontab.

```
use Helthe\Component\Chronos\Crontab;
use Helthe\Component\Chronos\Job\CommandJob;

$crontab = new Crontab();
$job = new CommandJob('@hourly', '/usr/bin/my_great_command');

$crontab->add($job);

$crontab->update();
```

### CronJobScheduler

[](#cronjobscheduler)

You can also programmatically run cron jobs.

```
use Helthe\Component\Chronos\CronJobScheduler;
use Helthe\Component\Chronos\Job\CommandJob;

$scheduler = new CronJobScheduler();
$job = new CommandJob('@hourly', '/usr/bin/my_great_command');

$scheduler->add($job);

$scheduler->runJobs();
```

Credits
-------

[](#credits)

Chronos was created to fill the need for managing recurring jobs in PHP. The initial inspiration for it was to have a [Whenever](https://github.com/javan/whenever) equivalent in PHP.

The CRON expression parser was initially based on the [parser](https://github.com/mtdowling/cron-expression)built by Michael Dowling.

Resources
---------

[](#resources)

You can run the unit tests with the following command:

```
$ cd path/to/Helthe/Component/XXX/
$ composer.phar install --dev
$ phpunit
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4718d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9dc50dba9cc5e4bf097f44026034daa66e2ed552549ba363304ff22914f4c0d1?d=identicon)[carlalexander](/maintainers/carlalexander)

---

Top Contributors

[![carlalexander](https://avatars.githubusercontent.com/u/654684?v=4)](https://github.com/carlalexander "carlalexander (10 commits)")

---

Tags

cronscheduleschedulingcrontabcron jobcron management

### Embed Badge

![Health badge](/badges/helthe-chronos/health.svg)

```
[![Health](https://phpackages.com/badges/helthe-chronos/health.svg)](https://phpackages.com/packages/helthe-chronos)
```

###  Alternatives

[orisai/scheduler

Cron job scheduler - with locks, parallelism and more

4037.1k4](/packages/orisai-scheduler)[omnilight/yii2-scheduling

Scheduling extension for Yii2 framework

3181.0M7](/packages/omnilight-yii2-scheduling)[mult1mate/cron-manager

Flexible cron tasks manager for MVC-type applications

40338.5k3](/packages/mult1mate-cron-manager)[guikingone/scheduler-bundle

A Symfony bundle that allows to schedule and create repetitive tasks

114217.4k](/packages/guikingone-scheduler-bundle)[shapecode/cron-bundle

This bundle provides scheduled execution of Symfony commands

59493.0k2](/packages/shapecode-cron-bundle)[fedemotta/yii2-cronjob

Yii2 extension to help in the creation of automated console scripts

2233.5k](/packages/fedemotta-yii2-cronjob)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)