function DbUpdateController::triggerBatch

Same name and namespace in other branches
  1. 9 core/modules/system/src/Controller/DbUpdateController.php \Drupal\system\Controller\DbUpdateController::triggerBatch()
  2. 8.9.x core/modules/system/src/Controller/DbUpdateController.php \Drupal\system\Controller\DbUpdateController::triggerBatch()
  3. 11.x core/modules/system/src/Controller/DbUpdateController.php \Drupal\system\Controller\DbUpdateController::triggerBatch()

Starts the database update batch process.

Parameters

\Symfony\Component\HttpFoundation\Request $request: The current request object.

1 call to DbUpdateController::triggerBatch()
DbUpdateController::handle in core/modules/system/src/Controller/DbUpdateController.php
Returns a database update page.

File

core/modules/system/src/Controller/DbUpdateController.php, line 591

Class

DbUpdateController
Controller routines for database update routes.

Namespace

Drupal\system\Controller

Code

protected function triggerBatch(Request $request) {
  $maintenance_mode = $this->state
    ->get('system.maintenance_mode', FALSE);
  // Store the current maintenance mode status in the session so that it can
  // be restored at the end of the batch.
  $request->getSession()
    ->set('maintenance_mode', $maintenance_mode);
  // During the update, always put the site into maintenance mode so that
  // in-progress schema changes do not affect visiting users.
  if (empty($maintenance_mode)) {
    $this->state
      ->set('system.maintenance_mode', TRUE);
  }
  /** @var \Drupal\Core\Batch\BatchBuilder $batch_builder */
  $batch_builder = (new BatchBuilder())->setTitle($this->t('Updating'))
    ->setInitMessage($this->t('Starting updates'))
    ->setErrorMessage($this->t('An unrecoverable error has occurred. You can find the error message below. It is advised to copy it to the clipboard for reference.'))
    ->setFinishCallback([
    DbUpdateController::class,
    'batchFinished',
  ]);
  // Resolve any update dependencies to determine the actual updates that will
  // be run and the order they will be run in.
  $start = $this->getModuleUpdates();
  $updates = update_resolve_dependencies($start);
  // Store the dependencies for each update function in an array which the
  // batch API can pass in to the batch operation each time it is called. (We
  // do not store the entire update dependency array here because it is
  // potentially very large.)
  $dependency_map = [];
  foreach ($updates as $function => $update) {
    $dependency_map[$function] = !empty($update['reverse_paths']) ? array_keys($update['reverse_paths']) : [];
  }
  // Determine updates to be performed.
  foreach ($updates as $function => $update) {
    if ($update['allowed']) {
      // Set the installed version of each module so updates will start at the
      // correct place. (The updates are already sorted, so we can simply base
      // this on the first one we come across in the above foreach loop.)
      if (isset($start[$update['module']])) {
        \Drupal::service('update.update_hook_registry')->setInstalledVersion($update['module'], $update['number'] - 1);
        unset($start[$update['module']]);
      }
      $batch_builder->addOperation('update_do_one', [
        $update['module'],
        $update['number'],
        $dependency_map[$function],
      ]);
    }
  }
  $post_updates = $this->postUpdateRegistry
    ->getPendingUpdateFunctions();
  if ($post_updates) {
    // Now we rebuild all caches and after that execute the hook_post_update()
    // functions.
    $batch_builder->addOperation('drupal_flush_all_caches', []);
    foreach ($post_updates as $function) {
      $batch_builder->addOperation('update_invoke_post_update', [
        $function,
      ]);
    }
  }
  batch_set($batch_builder->toArray());
  // @todo Revisit once https://www.drupal.org/node/2548095 is in.
  return batch_process(Url::fromUri('base://results'), Url::fromUri('base://start'));
}

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