QueueInterface

Type
Interface
Namespace
craft\queue
Implemented by
craft\queue\Queue
Since
3.0.0

QueueInterface defines the common interface to be implemented by queue classes.

View source (opens new window)

# Public Methods

Method Description
getHasReservedJobs() Returns whether there are any reserved jobs.
getHasWaitingJobs() Returns whether there are any waiting jobs.
getJobDetails() Returns detailed info about a single job.
getJobInfo() Returns info about the jobs in the queue.
getTotalJobs() Returns the total number of jobs in the queue.
release() Releases a job from the queue.
releaseAll() Releases all jobs.
retry() Re-adds a failed job to the queue.
retryAll() Retries all failed jobs.
run() Runs all the queued-up jobs.
setProgress() Sets the progress for the currently reserved job.

# getHasReservedJobs()

Returns whether there are any reserved jobs.

View source (opens new window)

Returns

boolean (opens new window)

# getHasWaitingJobs()

Returns whether there are any waiting jobs.

View source (opens new window)

Returns

boolean (opens new window)

# getJobDetails()

Since
3.4.0

Returns detailed info about a single job.

The response array can contain the following keys:

  • status – the job status (1 = waiting, 2 = reserved, 3 = done, 4 = failed)
  • progress – the job progress (0-100)
  • description – the job description
  • ttr – the job’s time-to-reserve, in seconds
  • error – the error message (if the job failed)
  • job – the deserialized job

Any other key/value pairs are allowed and will be displayed on the details page.

View source (opens new window)

Arguments

Returns

array (opens new window)

Throws