public function CronQueueTestBrokenQueue::processItem in Drupal 10

Same name and namespace in other branches

1. 8 core/modules/system/tests/modules/cron_queue_test/src/Plugin/QueueWorker/CronQueueTestBrokenQueue.php \Drupal\cron_queue_test\Plugin\QueueWorker\CronQueueTestBrokenQueue::processItem()
2. 9 core/modules/system/tests/modules/cron_queue_test/src/Plugin/QueueWorker/CronQueueTestBrokenQueue.php \Drupal\cron_queue_test\Plugin\QueueWorker\CronQueueTestBrokenQueue::processItem()

Works on a single queue item.

Parameters

mixed $data: The data that was passed to \Drupal\Core\Queue\QueueInterface::createItem() when the item was queued.

Throws

\Drupal\Core\Queue\RequeueException Processing is not yet finished. This will allow another process to claim the item immediately.

\Exception A QueueWorker plugin may throw an exception to indicate there was a problem. The cron process will log the exception, and leave the item in the queue to be processed again later.

\Drupal\Core\Queue\SuspendQueueException More specifically, a SuspendQueueException should be thrown when a QueueWorker plugin is aware that the problem will affect all subsequent workers of its queue. For example, a callback that makes HTTP requests may find that the remote server is not responding. The cron process will behave as with a normal Exception, and in addition will not attempt to process further items from the current item's queue during the current cron run.

Overrides QueueWorkerInterface::processItem

See also

\Drupal\Core\Cron::processQueues()

File

core/modules/system/tests/modules/cron_queue_test/src/Plugin/QueueWorker/CronQueueTestBrokenQueue.php, line 20

Class

CronQueueTestBrokenQueue

Plugin annotation @QueueWorker( id = "cron_queue_test_broken_queue", title = @Translation("Broken queue test"), cron = {"time" = 60} )

Namespace

Drupal\cron_queue_test\Plugin\QueueWorker

Code

public function processItem($data) {
  if ($data == 'crash') {
    throw new SuspendQueueException('The queue is broken.');
  }

  // Do nothing otherwise.
}