function callback_batch_finished

Same name in other branches
  1. 7.x modules/system/form.api.php \callback_batch_finished()
  2. 9 core/lib/Drupal/Core/Form/form.api.php \callback_batch_finished()
  3. 10 core/lib/Drupal/Core/Form/form.api.php \callback_batch_finished()
  4. 11.x core/lib/Drupal/Core/Form/form.api.php \callback_batch_finished()

Complete a batch process.

Callback for batch_set().

This callback may be specified in a batch to perform clean-up operations, or to analyze the results of the batch operations.

Parameters

$success: A boolean indicating whether the batch has completed successfully.

$results: The value set in $context['results'] by callback_batch_operation().

$operations: If $success is FALSE, contains the operations that remained unprocessed.

Related topics

File

core/lib/Drupal/Core/Form/form.api.php, line 113

Code

function callback_batch_finished($success, $results, $operations) {
    if ($success) {
        // Here we do something meaningful with the results.
        $message = t("@count items were processed.", [
            '@count' => count($results),
        ]);
        $list = [
            '#theme' => 'item_list',
            '#items' => $results,
        ];
        $message .= \Drupal::service('renderer')->render($list);
        \Drupal::messenger()->addStatus($message);
    }
    else {
        // An error occurred.
        // $operations contains the operations that remained unprocessed.
        $error_operation = reset($operations);
        $message = t('An error occurred while processing %error_operation with arguments: @arguments', [
            '%error_operation' => $error_operation[0],
            '@arguments' => print_r($error_operation[1], TRUE),
        ]);
        \Drupal::messenger()->addError($message);
    }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.