/**
* Enqueue a job for execution at a given timestamp.
*
* Identical to Resque::enqueue, however the first argument is a timestamp
* (either UNIX timestamp in integer format or an instance of the DateTime
* class in PHP).
*
* @param DateTime|int $at Instance of PHP DateTime object or int of UNIX timestamp.
* @param string $queue The name of the queue to place the job in.
* @param string $class The name of the class that contains the code to execute the job.
* @param array $args Any optional arguments that should be passed when the job is executed.
*/
public static function enqueueAt($at, $queue, $class, $args = [])
{
self::validateJob($class, $queue);
$job = self::jobToHash($queue, $class, $args);
self::delayedPush($at, $job);
return Event::trigger('afterSchedule', ['at' => $at, 'queue' => $queue, 'class' => $class, 'args' => $args]);
}
/**
* Schedule all of the delayed jobs for a given timestamp.
*
* Searches for all items for a given timestamp, pulls them off the list of
* delayed jobs and pushes them across to Resque.
*
* @param DateTime|int $timestamp Search for any items up to this timestamp to schedule.
*/
public function enqueueDelayedItemsForTimestamp($timestamp)
{
$item = null;
while ($item = ResqueScheduler::nextItemForTimestamp($timestamp)) {
$this->log('queueing ' . $item['class'] . ' in ' . $item['queue'] . ' [delayed]');
Event::trigger('beforeDelayedEnqueue', ['queue' => $item['queue'], 'class' => $item['class'], 'args' => $item['args']]);
$payload = array_merge([$item['queue'], $item['class']], $item['args']);
call_user_func_array('resque\\Resque::enqueue', $payload);
}
}
/**
* Create a new job and save it to the specified queue.
*
* @param string $queue The name of the queue to place the job in.
* @param string $class The name of the class that contains the code to execute the job.
* @param array $args Any optional arguments that should be passed when the job is executed.
* @param boolean $trackStatus Set to true to be able to monitor the status of a job.
*
* @return string|boolean Job ID when the job was created, false if creation was cancelled due to beforeEnqueue
*/
public static function enqueue($queue, $class, $args = null, $trackStatus = false)
{
$id = Resque::generateJobId();
$hookParams = ['class' => $class, 'args' => $args, 'queue' => $queue, 'id' => $id];
try {
Event::trigger('beforeEnqueue', $hookParams);
} catch (Job\DontCreate $e) {
return false;
}
Job::create($queue, $class, $args, $trackStatus, $id);
Event::trigger('afterEnqueue', $hookParams);
return $id;
}
/**
* Mark the current job as having failed.
*
* @param $exception
*/
public function fail($exception)
{
Event::trigger('onFailure', array('exception' => $exception, 'job' => $this));
$this->updateStatus(Status::STATUS_FAILED);
Failure::create($this->payload, $exception, $this->worker, $this->queue);
Stat::incr('failed');
Stat::incr('failed:' . $this->worker);
}
/**
* Perform necessary actions to start a worker.
*/
private function startup()
{
$this->registerSigHandlers();
$this->pruneDeadWorkers();
Event::trigger('beforeFirstFork', $this);
$this->registerWorker();
}
/**
* Create a new job and save it to the specified queue.
*
* @param string $queue The name of the queue to place the job in.
* @param string $class The name of the class that contains the code to execute the job.
* @param array $args Any optional arguments that should be passed when the job is executed.
* @param boolean $trackStatus Set to true to be able to monitor the status of a job.
*
* @return string
*/
public static function enqueue($queue, $class, $args = null, $trackStatus = false)
{
$result = Job::create($queue, $class, $args, $trackStatus);
if ($result) {
Event::trigger('afterEnqueue', array('class' => $class, 'args' => $args, 'queue' => $queue, 'id' => $result));
}
return $result;
}
