hook_cron_queue_info

Versions

mediamosa-21

hook_cron_queue_info()

Declare queues holding items that need to be run periodically.

While there can be only one hook_cron() process running at the same time, there can be any number of processes defined here running. Because of this, long running tasks are much better suited for this API. Items queued in hook_cron() might be processed in the same cron run if there are not many items in the queue, otherwise it might take several requests, which can be run in parallel.

See also

hook_cron()

@see hook_cron_queue_info_alter()

Return value

An associative array where the key is the queue name and the value is again an associative array. Possible keys are:

• 'worker callback': The name of the function to call. It will be called with one argument, the item created via DrupalQueue::createItem() in hook_cron().
• 'time': (optional) How much time Drupal should spend on calling this worker in seconds. Defaults to 15.

Related topics

Hooks

Allow modules to interact with the Drupal core.

Code

modules/system/system.api.php, line 387

<?php
function hook_cron_queue_info() {
  $queues['aggregator_feeds'] = array(
    'worker callback' => 'aggregator_refresh',
    'time' => 60,
  );
  return $queues;
}
?>