README

Last build status:

Manages linux crontab file by adding and deleting the appropriate entries. It is able to track the source file so that after the changes to this file, he will be able to enter and update the user's crontab file in safe way (doesn't remove entries added by user using crontab -e).

Installation

• copy files to your project
• include files from src directory or use some autoloader
• use it as described below

Requirements

If you are willing to use this tool as other user be sure enable appropriate entry into end of sudoers file (visudo) for ex.:

%developers ALL=(www-data)NOPASSWD:/usr/bin/crontab

Above means that users in a group developers can run program crontab as user www-data without need to enter the password.

Usage

Here is a simple example of use. Adding a simple task to crontab:

<?php
use qi\crontab\CrontabManager;

$crontab = new CrontabManager();
$job = $crontab->newJob();
$job->on('* * * * *');
$job->onMinute('20-30')->doJob("echo foo");
$crontab->add($job);
$job->onMinute('35-40')->doJob("echo bar");
$crontab->add($job);
$crontab->save();

A more complex example, but simpler to write. Adding and removing files to manage by the cron job. Files will be updated so as not to disrupt other tasks in the cron:

<?php
use qi\crontab\CrontabManager;

$crontab = new CrontabManager();
$crontab->enableOrUpdate('/tmp/my/crontab.txt');
$crontab->disable('/tmp/toremove.txt');
$crontab->save();

You can also use the built-in tools from the console: cronman located in the directory bin/ for ex.:

bin/cronman --enable /var/www/myproject/.cronfile --user www-data