QueueInterface

Type

Interface

Namespace

craft\queue

Extends

craft\queue\ReleasableQueueInterface

Implemented by

craft\queue\Queue

Since

3.0.0

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

View source

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

Returns

boolean

getHasWaitingJobs()

Returns whether there are any waiting jobs.

View source

Returns

boolean

getJobDetails()

Since

3.4.0

Returns detailed info about a single job.

The response array can contain the following keys:

• delay – the number of seconds remaining before the job will start
• status – the job status (1 = waiting, 2 = reserved, 3 = done, 4 = failed)
• progress – the job progress (0-100)
• progressLabel – the progress label (lazy-translated with craft\i18n\Translation::translate())
• description – the job description (lazy-translated with craft\i18n\Translation::translate())
• 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

Arguments

• $id (string)

Returns

array

Throws

• yii\base\InvalidArgumentException
  if $id is an invalid job ID

getJobInfo()

Returns info about the jobs in the queue.

The response array should have sub-arrays with the following keys:

• id – the job ID
• delay – the number of seconds remaining before the job will start
• status – the job status (1 = waiting, 2 = reserved, 3 = done, 4 = failed)
• progress – the job progress (0-100)
• progressLabel – the progress label (lazy-translated with craft\i18n\Translation::translate())
• description – the job description (lazy-translated with craft\i18n\Translation::translate())
• error – the error message (if the job failed)

View source

Arguments

• $limit (integer, null)

Returns

array

getTotalJobs()

Since

3.4.0

Returns the total number of jobs in the queue.

View source

Returns

integer

retry()

Re-adds a failed job to the queue.

View source

Arguments

• $id (string)

retryAll()

Since

3.4.0

Retries all failed jobs.

View source

run()

Runs all the queued-up jobs.

View source

Returns

mixed

setProgress()

Sets the progress for the currently reserved job.

View source

Arguments

• $progress (integer) – The job progress (1-100)
• $label (string, null) – The progress label