Yii2 extension to help in the creation of automated console scripts

Installs: 29 141

Dependents: 0

Suggesters: 0

Security: 0

Stars: 22

Watchers: 8

Forks: 9

Open Issues: 1


v1.1 2015-10-07 20:47 UTC

This package is not auto-updated.

Last update: 2024-05-25 16:28:30 UTC


Latest Stable Version Total Downloads Latest Unstable Version License

Yii2 extension to help in the creation of automated console scripts. It helps to manage the execution of console scripts, for example avoiding the execution if the previous cron is already running. It generates a history of cron executed, with the time spent and helps to batch processing the script.


The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist fedemotta/yii2-cronjob "*"

or add

"fedemotta/yii2-cronjob": "*"

to the require section of your composer.json file.

This extension needs a database to manage the cron job execution. Run the following migration to create the table structure:

yii migrate --migrationPath=@fedemotta/cronjob/migrations


Once the extension is installed, you can use it as a helper in your console controller.

See the following example:

namespace somenamespace\controllers;

use fedemotta\cronjob\models\CronJob;
use somenamespace\SomeModel;
use yii\console\Controller;

 * SomeContrController controller
class SomeContrController extends Controller {
     * Run SomeModel::some_method for a period of time
     * @param string $from
     * @param string $to
     * @return int exit code
    public function actionInit($from, $to){
        $dates  = CronJob::getDateRange($from, $to);
        $command = CronJob::run($this->id, $this->action->id, 0, CronJob::countDateRange($dates));
        if ($command === false){
            return Controller::EXIT_CODE_ERROR;
            foreach ($dates as $date) {
                //this is the function to execute for each day
                SomeModel::some_method((string) $date);
            return Controller::EXIT_CODE_NORMAL;
     * Run SomeModel::some_method for today only as the default action
     * @return int exit code
    public function actionIndex(){
        return $this->actionInit(date("Y-m-d"), date("Y-m-d"));
     * Run SomeModel::some_method for yesterday
     * @return int exit code
    public function actionYesterday(){
        return $this->actionInit(date("Y-m-d", strtotime("-1 days")), date("Y-m-d", strtotime("-1 days")));

Run the SomeModel::some_method for today:

./yii some-contr

For yesterday:

./yii some-contr/yesterday

For some custom dates like this:

./yii some-contr/init 2010-10-10 2012-10-10

And you can add a cron job to run every 10 minutes with some controller action like this:

*/10 * * * * /path/to/yii/application/yii some-contr/yesterday >> /var/log/console-app.log 2>&1