Same name and namespace in other branches
  1. 6.x includes/batch.inc \_batch_process()
  2. 7.x includes/batch.inc \_batch_process()
  3. 8.9.x core/includes/batch.inc \_batch_process()
  4. 9 core/includes/batch.inc \_batch_process()

Processes sets in a batch.

If the batch was marked for progressive execution (default), this executes as many operations in batch sets until an execution time of 1 second has been exceeded. It will continue with the next operation of the same batch set in the next request.

Return value

array An array containing a completion value (in percent) and a status message.

3 calls to _batch_process()
batch_process in core/includes/form.inc
Processes the batch.
_batch_do in core/includes/batch.inc
Does one execution pass with JavaScript and returns progress to the browser.
_batch_progress_page in core/includes/batch.inc
Outputs a batch processing page.

File

core/includes/batch.inc, line 252
Batch processing API for processes to run in multiple HTTP requests.

Code

function _batch_process() {
  $batch =& batch_get();
  $current_set =& _batch_current_set();

  // Indicate that this batch set needs to be initialized.
  $set_changed = TRUE;
  $task_message = '';

  // If this batch was marked for progressive execution (e.g. forms submitted by
  // \Drupal::formBuilder()->submitForm(), initialize a timer to determine
  // whether we need to proceed with the same batch phase when a processing time
  // of 1 second has been exceeded.
  if ($batch['progressive']) {
    Timer::start('batch_processing');
  }
  if (empty($current_set['start'])) {
    $current_set['start'] = microtime(TRUE);
  }
  $queue = _batch_queue($current_set);
  while (!$current_set['success']) {

    // If this is the first time we iterate this batch set in the current
    // request, we check if it requires an additional file for functions
    // definitions.
    if ($set_changed && isset($current_set['file']) && is_file($current_set['file'])) {
      include_once \Drupal::root() . '/' . $current_set['file'];
    }
    $task_message = '';

    // Assume a single pass operation and set the completion level to 1 by
    // default.
    $finished = 1;
    if ($item = $queue
      ->claimItem()) {
      [
        $callback,
        $args,
      ] = $item->data;

      // Build the 'context' array and execute the function call.
      $batch_context = [
        'sandbox' => &$current_set['sandbox'],
        'results' => &$current_set['results'],
        'finished' => &$finished,
        'message' => &$task_message,
      ];
      call_user_func_array($callback, array_merge($args, [
        &$batch_context,
      ]));
      if ($finished >= 1) {

        // Make sure this step is not counted twice when computing $current.
        $finished = 0;

        // Remove the processed operation and clear the sandbox.
        $queue
          ->deleteItem($item);
        $current_set['count']--;
        $current_set['sandbox'] = [];
      }
    }

    // When all operations in the current batch set are completed, browse
    // through the remaining sets, marking them 'successfully processed'
    // along the way, until we find a set that contains operations.
    // _batch_next_set() executes form submit handlers stored in 'control'
    // sets (see \Drupal::service('form_submitter')), which can in turn add new
    // sets to the batch.
    $set_changed = FALSE;
    $old_set = $current_set;
    while (empty($current_set['count']) && ($current_set['success'] = TRUE) && _batch_next_set()) {
      $current_set =& _batch_current_set();
      $current_set['start'] = microtime(TRUE);
      $set_changed = TRUE;
    }

    // At this point, either $current_set contains operations that need to be
    // processed or all sets have been completed.
    $queue = _batch_queue($current_set);

    // If we are in progressive mode, break processing after 1 second.
    if ($batch['progressive'] && Timer::read('batch_processing') > 1000) {

      // Record elapsed wall clock time.
      $current_set['elapsed'] = round((microtime(TRUE) - $current_set['start']) * 1000, 2);
      break;
    }
  }
  if ($batch['progressive']) {

    // Gather progress information.
    // Reporting 100% progress will cause the whole batch to be considered
    // processed. If processing was paused right after moving to a new set,
    // we have to use the info from the new (unprocessed) set.
    if ($set_changed && isset($current_set['queue'])) {

      // Processing will continue with a fresh batch set.
      $remaining = $current_set['count'];
      $total = $current_set['total'];
      $progress_message = $current_set['init_message'];
      $task_message = '';
    }
    else {

      // Processing will continue with the current batch set.
      $remaining = $old_set['count'] ?? 0;
      $total = $old_set['total'] ?? 0;
      $progress_message = $old_set['progress_message'] ?? '';
    }

    // Total progress is the number of operations that have fully run plus the
    // completion level of the current operation.
    $current = $total - $remaining + ($finished ?? 0);
    $percentage = _batch_api_percentage($total, $current);
    $elapsed = $current_set['elapsed'] ?? 0;
    $values = [
      '@remaining' => $remaining,
      '@total' => $total,
      '@current' => floor($current),
      '@percentage' => $percentage,
      '@elapsed' => \Drupal::service('date.formatter')
        ->formatInterval((int) ($elapsed / 1000)),
      // If possible, estimate remaining processing time.
      '@estimate' => $current > 0 ? \Drupal::service('date.formatter')
        ->formatInterval((int) ($elapsed * ($total - $current) / $current / 1000)) : '-',
    ];
    $message = strtr($progress_message, $values);
    return [
      $percentage,
      $message,
      $task_message,
    ];
  }
  else {

    // If we are not in progressive mode, the entire batch has been processed.
    return _batch_finished();
  }
}