krydos/php-notifier

PHP task scheduler

, _(*1)

PHPNotifier

PHPNotifier - is a task scheduler. Allows you to schedule a task that will be executed at any time you wish., _(*2)

Installation

add to your composer.json - "krydos/php-notifier": "*", _(*3)

Usage

First of all you have to run a script that will be listening for new tasks and execute them when time came., _(*4)

php ./vendor/bin/phpnotifier /absolute/path/to/db.file, _(*5)

or if you want to leave it working in background, _(*6)

nohup php ./vendor/bin/phpnotifier /absolute/path/to/db.file & >/dev/null 2>&1 &, _(*7)

Using nohup you can see log output in nohup.out file., _(*8)

How to create new tasks:, _(*9)

use \PHPNotifier\PHPNotifier;

$scheduler = new PHPNotifier(PHPNotifier::FILE_METHOD, '/absolute/path/to/db.file');
$scheduler->scheduleTaskIn(10, 'echo', [
    'Hello world!'
    '>'
    'any_file'
]);  

This task will be executed in 10 seconds. Command that will be executed is echo Hello world! > any_file, _(*10)

Since sometimes you know exact time when you want to run a task and you don't want to calculate how many time is remaining there is another method exists - scheduleTaskAtTime with same signature., _(*11)

use \PHPNotifier\PHPNotifier;

$scheduler = new PHPNotifier(PHPNotifier::FILE_METHOD, '/absolute/path/to/db.file');
$scheduler->scheduleTaskAtTime(1459382400, 'echo', [
    'Hello world!'
    '>'
    'any_file'
]);  

This method accepts unix timestamp or \DateTime object as first argument. If you use DateTime PHP's object you can get this value by getTimestamp() method., _(*12)

make sure that binary you're trying to execute is exists in your system, _(*13)

TODO

• support Redis as task store method
• support as many store methods as possible
• ~~ability to accept DateTime as first argument for scheduleTaskAtTime method~~
• ~~ability to accept any valid date string as first argument of scheduleTaskAtTime method~~
• ability to schedule repeatable tasks

Contributing

There are no special rules. Just send a pull request or create an issue., _(*14)