batch_test.callbacks.inc

Same filename and directory in other branches
  1. 7.x modules/simpletest/tests/batch_test.callbacks.inc
  2. 9 core/modules/system/tests/modules/batch_test/batch_test.callbacks.inc
  3. 8.9.x core/modules/system/tests/modules/batch_test/batch_test.callbacks.inc
  4. 10 core/modules/system/tests/modules/batch_test/batch_test.callbacks.inc

Batch callbacks for the Batch API tests.

File

core/modules/system/tests/modules/batch_test/batch_test.callbacks.inc

View source
<?php


/**
 * @file
 * Batch callbacks for the Batch API tests.
 */
use Drupal\Component\Utility\Html;
use Drupal\Core\Url;
use Symfony\Component\HttpFoundation\RedirectResponse;

/**
 * Implements callback_batch_operation().
 *
 * Performs a simple batch operation.
 */
function _batch_test_callback_1($id, $sleep, &$context) {
    // No-op, but ensure the batch takes a couple iterations.
    // Batch needs time to run for the test, so sleep a bit.
    usleep($sleep);
    // Track execution, and store some result for post-processing in the
    // 'finished' callback.
    batch_test_stack("op 1 id {$id}");
    $context['results'][1][] = $id;
}

/**
 * Implements callback_batch_operation().
 *
 * Performs a multistep batch operation.
 */
function _batch_test_callback_2($start, $total, $sleep, &$context) {
    // Initialize context with progress information.
    if (!isset($context['sandbox']['current'])) {
        $context['sandbox']['current'] = $start;
        $context['sandbox']['count'] = 0;
    }
    // Process by groups of 5 (arbitrary value).
    $limit = 5;
    for ($i = 0; $i < $limit && $context['sandbox']['count'] < $total; $i++) {
        // No-op, but ensure the batch takes a couple iterations.
        // Batch needs time to run for the test, so sleep a bit.
        usleep($sleep);
        // Track execution, and store some result for post-processing in the
        // 'finished' callback.
        $id = $context['sandbox']['current'] + $i;
        batch_test_stack("op 2 id {$id}");
        $context['results'][2][] = $id;
        // Update progress information.
        $context['sandbox']['count']++;
    }
    $context['sandbox']['current'] += $i;
    // Inform batch engine about progress.
    if ($context['sandbox']['count'] != $total) {
        $context['finished'] = $context['sandbox']['count'] / $total;
    }
}

/**
 * Implements callback_batch_operation().
 */
function _batch_test_callback_5($id, $sleep, &$context) {
    // No-op, but ensure the batch takes a couple iterations.
    // Batch needs time to run for the test, so sleep a bit.
    usleep($sleep);
    // Track execution, and store some result for post-processing in the
    // 'finished' callback.
    batch_test_stack("op 5 id {$id}");
    $context['results'][5][] = $id;
    // This test is to test finished > 1
    $context['finished'] = 3.14;
}

/**
 * Implements callback_batch_operation().
 *
 * Performs a simple batch operation.
 */
function _batch_test_callback_6($id, $sleep, &$context) {
    // No-op, but ensure the batch takes a couple iterations.
    // Batch needs time to run for the test, so sleep a bit.
    usleep($sleep);
    // Track execution, and store some result for post-processing in the
    // 'finished' callback.
    batch_test_stack("op 6 id {$id}");
    $context['results'][6][] = $id;
}

/**
 * Implements callback_batch_operation().
 *
 * Performs a simple batch operation.
 */
function _batch_test_callback_7($id, $sleep, &$context) {
    // No-op, but ensure the batch takes a couple iterations.
    // Batch needs time to run for the test, so sleep a bit.
    usleep($sleep);
    // Track execution, and store some result for post-processing in the
    // 'finished' callback.
    batch_test_stack("op 7 id {$id}");
    $context['results'][7][] = $id;
}

/**
 * Implements callback_batch_operation().
 *
 * Performs a simple batch operation that optionally throws an exception.
 */
function _batch_test_callback_8(bool $throw_exception) : void {
    usleep(500);
    if ($throw_exception) {
        throw new Exception('Exception in batch');
    }
}

/**
 * Implements callback_batch_operation().
 *
 * Performs a batch operation setting up its own batch(es).
 */
function _batch_test_nested_batch_callback(array $batches = []) {
    foreach ($batches as $batch) {
        batch_test_stack("setting up batch {$batch}");
        $function = '_batch_test_batch_' . $batch;
        batch_set($function());
    }
    \Drupal::state()->set('batch_test_nested_order_multiple_batches', batch_get());
}

/**
 * Provides a common 'finished' callback for batches 1 to 7.
 */
function _batch_test_finished_helper($batch_id, $success, $results, $operations, $elapsed) {
    if ($results) {
        foreach ($results as $op => $op_results) {
            $messages[] = 'op ' . Html::escape($op) . ': processed ' . count($op_results) . ' elements';
        }
    }
    else {
        $messages[] = 'none';
    }
    if (!$success) {
        // A fatal error occurred during the processing.
        $error_operation = reset($operations);
        $messages[] = t('An error occurred while processing @op with arguments:<br />@args', [
            '@op' => $error_operation[0],
            '@args' => print_r($error_operation[1], TRUE),
        ]);
    }
    // Use item list template to render the messages.
    $error_message = [
        '#type' => 'inline_template',
        '#template' => 'results for batch {{ batch_id }} ({{ elapsed }}){{ errors }}',
        '#context' => [
            'batch_id' => $batch_id,
            'elapsed' => $elapsed,
            'errors' => [
                '#theme' => 'item_list',
                '#items' => $messages,
            ],
        ],
    ];
    \Drupal::messenger()->addStatus(\Drupal::service('renderer')->renderInIsolation($error_message));
    \Drupal::messenger()->addMessage('elapsed time: ' . $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 0.
 */
function _batch_test_finished_0($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(0, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 1.
 */
function _batch_test_finished_1($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(1, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 1.
 */
function _batch_test_finished_1_finished($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(1, $success, $results, $operations, $elapsed);
    return new RedirectResponse(Url::fromRoute('test_page_test.test_page', [], [
        'absolute' => TRUE,
    ])->toString());
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 2.
 */
function _batch_test_finished_2($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(2, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 3.
 */
function _batch_test_finished_3($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(3, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 4.
 */
function _batch_test_finished_4($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(4, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 5.
 */
function _batch_test_finished_5($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(5, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 6.
 */
function _batch_test_finished_6($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(6, $success, $results, $operations, $elapsed);
}

/**
 * Implements callback_batch_finished().
 *
 * Triggers 'finished' callback for batch 7.
 */
function _batch_test_finished_7($success, $results, $operations, $elapsed) {
    _batch_test_finished_helper(7, $success, $results, $operations, $elapsed);
}

Functions

Title Deprecated Summary
_batch_test_callback_1 Implements callback_batch_operation().
_batch_test_callback_2 Implements callback_batch_operation().
_batch_test_callback_5 Implements callback_batch_operation().
_batch_test_callback_6 Implements callback_batch_operation().
_batch_test_callback_7 Implements callback_batch_operation().
_batch_test_callback_8 Implements callback_batch_operation().
_batch_test_finished_0 Implements callback_batch_finished().
_batch_test_finished_1 Implements callback_batch_finished().
_batch_test_finished_1_finished Implements callback_batch_finished().
_batch_test_finished_2 Implements callback_batch_finished().
_batch_test_finished_3 Implements callback_batch_finished().
_batch_test_finished_4 Implements callback_batch_finished().
_batch_test_finished_5 Implements callback_batch_finished().
_batch_test_finished_6 Implements callback_batch_finished().
_batch_test_finished_7 Implements callback_batch_finished().
_batch_test_finished_helper Provides a common 'finished' callback for batches 1 to 7.
_batch_test_nested_batch_callback Implements callback_batch_operation().

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