batch_test.module

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

Helper module for the Batch API tests.

File

core/modules/system/tests/modules/batch_test/batch_test.module

View source
<?php


/**
 * @file
 * Helper module for the Batch API tests.
 */
use Drupal\Core\Batch\BatchBuilder;
use Drupal\Core\Form\FormState;

/**
 * Batch operation: Submits form_test_mock_form().
 */
function _batch_test_nested_drupal_form_submit_callback($value) {
    $form_state = (new FormState())->setValue('test_value', $value);
    \Drupal::formBuilder()->submitForm('Drupal\\batch_test\\Form\\BatchTestMockForm', $form_state);
}

/**
 * Batch 0: Does nothing.
 */
function _batch_test_batch_0() {
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_0');
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_0',
    ];
}

/**
 * Batch 1: Repeats a simple operation.
 *
 * Operations: op 1 from 1 to 10.
 */
function _batch_test_batch_1() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_1');
    for ($i = 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_1', [
            $i,
            $sleep,
        ]);
    }
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_1',
    ];
}

/**
 * Batch 2: Performs a single multistep operation.
 *
 * Operations: op 2 from 1 to 10.
 */
function _batch_test_batch_2() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->addOperation('_batch_test_callback_2', [
        1,
        $total,
        $sleep,
    ])
        ->setFinishCallback('_batch_test_finished_2');
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_2',
    ];
}

/**
 * Batch 3: Performs both single and multistep operations.
 *
 * Operations:
 * - op 1 from 1 to 5,
 * - op 2 from 1 to 5,
 * - op 1 from 6 to 10,
 * - op 2 from 6 to 10.
 */
function _batch_test_batch_3() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_3');
    for ($i = 1; $i <= round($total / 2); $i++) {
        $batch_builder->addOperation('_batch_test_callback_1', [
            $i,
            $sleep,
        ]);
    }
    $batch_builder->addOperation('_batch_test_callback_2', [
        1,
        $total / 2,
        $sleep,
    ]);
    for ($i = round($total / 2) + 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_1', [
            $i,
            $sleep,
        ]);
    }
    $batch_builder->addOperation('_batch_test_callback_2', [
        6,
        $total / 2,
        $sleep,
    ]);
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_3',
    ];
}

/**
 * Batch 4: Performs a batch within a batch.
 *
 * Operations:
 * - op 1 from 1 to 5,
 * - set batch 2 (op 2 from 1 to 10, should run at the end)
 * - op 1 from 6 to 10,
 */
function _batch_test_batch_4() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_4');
    for ($i = 1; $i <= round($total / 2); $i++) {
        $batch_builder->addOperation('_batch_test_callback_1', [
            $i,
            $sleep,
        ]);
    }
    $batch_builder->addOperation('_batch_test_nested_batch_callback', [
        [
            2,
        ],
    ]);
    for ($i = round($total / 2) + 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_1', [
            $i,
            $sleep,
        ]);
    }
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_4',
    ];
}

/**
 * Batch 5: Repeats a simple operation.
 *
 * Operations: op 1 from 1 to 10.
 */
function _batch_test_batch_5() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_5');
    for ($i = 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_5', [
            $i,
            $sleep,
        ]);
    }
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_5',
    ];
}

/**
 * Batch 6: Repeats a simple operation.
 *
 * Operations: op 6 from 1 to 10.
 */
function _batch_test_batch_6() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_6');
    for ($i = 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_6', [
            $i,
            $sleep,
        ]);
    }
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_6',
    ];
}

/**
 * Batch 7: Performs two batches within a batch.
 *
 * Operations:
 * - op 7 from 1 to 5,
 * - set batch 5 (op 5 from 1 to 10, should run at the end before batch 2)
 * - set batch 6 (op 6 from 1 to 10, should run at the end after batch 1)
 * - op 7 from 6 to 10,
 */
function _batch_test_batch_7() {
    // Ensure the batch takes at least two iterations.
    $total = 10;
    $sleep = 1000000 / $total * 2;
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->setFinishCallback('_batch_test_finished_7');
    for ($i = 1; $i <= $total / 2; $i++) {
        $batch_builder->addOperation('_batch_test_callback_7', [
            $i,
            $sleep,
        ]);
    }
    $batch_builder->addOperation('_batch_test_nested_batch_callback', [
        [
            6,
            5,
        ],
    ]);
    for ($i = $total / 2 + 1; $i <= $total; $i++) {
        $batch_builder->addOperation('_batch_test_callback_7', [
            $i,
            $sleep,
        ]);
    }
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_7',
    ];
}

/**
 * Batch 8: Throws an exception.
 */
function _batch_test_batch_8() : array {
    $batch_builder = (new BatchBuilder())->setFile(\Drupal::service('extension.list.module')->getPath('batch_test') . '/batch_test.callbacks.inc')
        ->addOperation('_batch_test_callback_8', [
        FALSE,
    ])
        ->addOperation('_batch_test_callback_8', [
        TRUE,
    ]);
    return $batch_builder->toArray() + [
        'batch_test_id' => 'batch_8',
    ];
}

/**
 * Implements callback_batch_operation().
 *
 * Tests the progress page theme.
 */
function _batch_test_theme_callback() {
    // Because drupalGet() steps through the full progressive batch before
    // returning control to the test function, we cannot test that the correct
    // theme is being used on the batch processing page by viewing that page
    // directly. Instead, we save the theme being used in a variable here, so
    // that it can be loaded and inspected in the thread running the test.
    $theme = \Drupal::theme()->getActiveTheme()
        ->getName();
    batch_test_stack($theme);
}

/**
 * Tests the title on the progress page by performing a batch callback.
 */
function _batch_test_title_callback() {
    // Because drupalGet() steps through the full progressive batch before
    // returning control to the test function, we cannot test that the correct
    // title is being used on the batch processing page by viewing that page
    // directly. Instead, we save the title being used in a variable here, so
    // that it can be loaded and inspected in the thread running the test.
    $request = \Drupal::request();
    $route_match = \Drupal::routeMatch();
    $title = \Drupal::service('title_resolver')->getTitle($request, $route_match->getRouteObject());
    batch_test_stack($title);
}

/**
 * Helper function: Stores or retrieves traced execution data.
 */
function batch_test_stack($data = NULL, $reset = FALSE) {
    $state = \Drupal::state();
    if ($reset) {
        $state->delete('batch_test.stack');
    }
    if (!isset($data)) {
        return $state->get('batch_test.stack');
    }
    $stack = $state->get('batch_test.stack');
    $stack[] = $data;
    $state->set('batch_test.stack', $stack);
}

Functions

Title Deprecated Summary
batch_test_stack Helper function: Stores or retrieves traced execution data.
_batch_test_batch_0 Batch 0: Does nothing.
_batch_test_batch_1 Batch 1: Repeats a simple operation.
_batch_test_batch_2 Batch 2: Performs a single multistep operation.
_batch_test_batch_3 Batch 3: Performs both single and multistep operations.
_batch_test_batch_4 Batch 4: Performs a batch within a batch.
_batch_test_batch_5 Batch 5: Repeats a simple operation.
_batch_test_batch_6 Batch 6: Repeats a simple operation.
_batch_test_batch_7 Batch 7: Performs two batches within a batch.
_batch_test_batch_8 Batch 8: Throws an exception.
_batch_test_nested_drupal_form_submit_callback Batch operation: Submits form_test_mock_form().
_batch_test_theme_callback Implements callback_batch_operation().
_batch_test_title_callback Tests the title on the progress page by performing a batch callback.

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