PHPackages                             peopleperhour/yii2-cronjobs - 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. peopleperhour/yii2-cronjobs

ActiveYii2-extension[Utility & Helpers](/categories/utility)

peopleperhour/yii2-cronjobs
===========================

cronjobs scheduler for yii2

112.5k↓50%1[1 issues](https://github.com/PeoplePerHour/yii2-cronjobs/issues)PHP

Since Nov 30Pushed 10y ago4 watchersCompare

[ Source](https://github.com/PeoplePerHour/yii2-cronjobs)[ Packagist](https://packagist.org/packages/peopleperhour/yii2-cronjobs)[ RSS](/packages/peopleperhour-yii2-cronjobs/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Yii2 cronjobs extension
=======================

[](#yii2-cronjobs-extension)

Easiest way to put crontab on your console scripts.

This extension is based on [this repo](https://github.com/Yiivgeny/Yii-PHPDocCrontab) for yii1 and [this](https://github.com/DenisOgr/yii2-cronjobs) for yii2.

The peopleperhour package adds some more features such as

1. extra logging
2. correct cron-tags functionality

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

[](#installation)

- **Step 1:** The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

Either run

```
php composer.phar require --prefer-dist peopleperhour/yii2-cronjobs "dev-master"

```

or add

```
"peopleperhour/yii2-cronjobs": "dev-master"

```

to the require section of your `composer.json` file.

- **Step 2:** Set aliase @runnerScript in console config. This absolutely path to runner script (I can not find another way to get runner script). Change path to runner script as your project.

```
Yii::setAlias('@runnerScript', dirname(dirname(dirname(__FILE__))) .'/yii');

```

- **Step 3:** Add to console config:

```
'controllerMap' => [
       'cron' => [
           'class' => 'peopleperhour\cronjobs\CronController'
       ],
   ],

```

- **Step 4:** Add task to system scheduler (cron on unix, task scheduler on windows, systemd service) to run every minute:

```
* * * * * /path/to/yii/application/protected/yii cron
```

Add in params array with cron sets:

```
'params' => [
  'test/example1' => [
    'cron'      => '* * * * *',
  ],
  'test/example2' => [
    'cron'      => '10 * * * *',
  ],
],

```

- **Step 5:** Add logging

There are two levels of logging provided.

a) Log the output of the cron mechanism

Logs events coming into the cron mechanism.

Sample Output:

2015-06-11 09:48:36 \[-\]\[-\]\[-\]\[info\]\[cronjobs\] Running task \[1\]: runtestcron test in /var/www/vendor/peopleperhour/yii2-cronjobs/CronController.php:260 2015-06-11 09:48:36 \[-\]\[-\]\[-\]\[info\]\[cronjobs\] Runned 1 task(s) at Thu, 11 Jun 2015 09:48:36 +0000 in /var/www/vendor/peopleperhour/yii2-cronjobs/CronController.php:264

Set up:

In your config, set the below in your log component:

```
'components' => [
  'log' => [
    'targets' => [
      [
        'class'         => 'yii\log\FileTarget',
        'logFile'       => 'somelogfile.log',
        'categories'    => ['yii2-cronjobs']
      ],
    ],
  ],
]

```

The "categories" element is the default category used in the peopleperhour/yii2-cronjobs extension. If you want to change it then enter the name desired above and also set the logsCategory field in the controllerMap.

eg.

```
'controllerMap' => [
       'cron' => [
           'class'        => 'peopleperhour\cronjobs\CronController',
           'logsCategory' => 'somenewcategory',
       ],
   ],

```

b) Log the output of commands running

There are two ways to log the output of the commands running.

First is the catchall way, where you add the filename to your controllerMap.

eg

```
'controllerMap' => [
       'cron' => [
           'class'        => 'peopleperhour\cronjobs\CronController',
           'logFileName'  => 'somelog',
       ],
   ],

```

Secondly you can specify the output of each cron command specifically by changing the cron specification using the "cron-stdout" directive.

```
'params' => [
  'test/example1' => [
    'cron'        => '* * * * *',
    'cron-stdout' => 'example1-out',
    'cron-stderr' => 'example1-err'
  ],
  'test/example2' => [
    'cron'      => '10 * * * *',
  ],
],

```

The above will overwrite the catchall output of the controllerMap and send the output to the cron-stdout specified log file.

- **Step 6:** Add tags to run on specific environments

Should you need to separate environments when running your crons you can add a cron-tags parameter to the cron config

```
'params' => [
  'test/example1' => [
    'cron'        => '* * * * *',
    'cron-stdout' => 'example1-out',
    'cron-stderr' => 'example1-err'
    'cron-tags'   => 'live staging'
  ],
],

```

Then run your cron command with the tag requested inside your scheduler

eg

```
* * * * * /path/to/yii/application/protected/yii cron live
```

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 52.6% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/6e678039a4535dc5ab805aac3091d68244dd56e747b54ed3a03533732594af60?d=identicon)[peopleperhour](/maintainers/peopleperhour)

---

Top Contributors

[![DenisOgr](https://avatars.githubusercontent.com/u/1311408?v=4)](https://github.com/DenisOgr "DenisOgr (20 commits)")[![spyrospph](https://avatars.githubusercontent.com/u/714938?v=4)](https://github.com/spyrospph "spyrospph (17 commits)")[![alexweb](https://avatars.githubusercontent.com/u/106749173?v=4)](https://github.com/alexweb "alexweb (1 commits)")

### Embed Badge

![Health badge](/badges/peopleperhour-yii2-cronjobs/health.svg)

```
[![Health](https://phpackages.com/badges/peopleperhour-yii2-cronjobs/health.svg)](https://phpackages.com/packages/peopleperhour-yii2-cronjobs)
```

###  Alternatives

[topthink/think-helper

The ThinkPHP6 Helper Package

962.4M241](/packages/topthink-think-helper)[elements/process-manager-bundle

The Process Manager allows you to manage (define,execute...) arbitrary processes/commands in the Pimcore backend.

49633.0k5](/packages/elements-process-manager-bundle)[ijeffro/laravel-cities

Laravel Cities is a bundle for Laravel, providing Iata Code ISO 3166 3 and country codes for all the cities.

118.2k](/packages/ijeffro-laravel-cities)

PHPackages © 2026

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