Reference Guide

Zend Server Reference Manual
Ranges for each field:
Field Range Comments
Minute 0 - 59
Hour 0 - 23 In 24 hour format, where 0 is midnight
Day of Month 1 - 31 29,30 and 31 will only work for months of that length
Month 1 - 12
Day of Week 0 - 7 Sunday is either 0 or 7
One-Time Deferred Tasks (jobs)
This procedure describes how to create a one-time deferred task. In some use cases, it makes sense to
defer a certain task to a later time. For example, many applications have clear peak hours (e.g. between
8am and 11pm, or like in many Intranet applications, during office work hours).
If these applications need to perform some off-line processing, it might make sense to defer some of the
heavy processing tasks to off hours (in our examples to late night or early morning hours), in order to
maximize the efficiency of hardware utilization.
Note
136
To create a time deferred task:
1. Follow the instructions in Queued Jobs to create an createHttpJob job using the API.
2. Pass a date/time string as the schedule_time option, as part of the options array passed
as the 3rd parameter to createHttpJob().
The format used in date() to pass the execution time – this is an SQL-like ‘YYYY-MM-DD
hh:mm:ss’format (e.g. “2009-06-25 23:45:00” for June 25th 2009 at 45 minutes past 11pm).
Zend Job Queue is not designed to execute jobs exactly on the specified time. For example, if the queue
is limited to execute 10 jobs concurrently (more on that later on), and 1,000 jobs are scheduled for the
exact same time – jobs will have to wait until other jobs finish. You should consider the schedule_time
option as a request not to run a job before this time.
Example:
The following example shows a time-deferred task that has been scheduled to run a process at
2:00am.
$options = array(
'schedule_time' => date('Y-m-d h:i:s', strtotime('tomorrow 2am'))
);
$jq->createHttpJob('http://localhost/jobs/formproc.php', $_POST,
$options);