function DbUpdateController::results

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

Displays results of the update script with any accompanying errors.

Parameters

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

Return value

array A render array.

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

File

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

Class

DbUpdateController
Controller routines for database update routes.

Namespace

Drupal\system\Controller

Code

protected function results(Request $request) {
  // @todo Simplify with https://www.drupal.org/node/2548095
  $base_url = str_replace('/update.php', '', $request->getBaseUrl());
  // Retrieve and remove session information.
  $session = $request->getSession();
  $update_results = $session->remove('update_results');
  $update_success = $session->remove('update_success');
  $session->remove('update_ignore_warnings');
  // Report end result.
  $dblog_exists = $this->moduleHandler
    ->moduleExists('dblog');
  if ($dblog_exists && $this->account
    ->hasPermission('access site reports')) {
    $log_message = $this->t('All errors have been <a href=":url">logged</a>.', [
      ':url' => Url::fromRoute('dblog.overview')->setOption('base_url', $base_url)
        ->toString(TRUE)
        ->getGeneratedUrl(),
    ]);
  }
  else {
    $log_message = $this->t('All errors have been logged.');
  }
  if ($update_success) {
    $message = '<p>' . $this->t('Updates were attempted. If you see no failures below, you may proceed happily back to your <a href=":url">site</a>. Otherwise, you may need to update your database manually.', [
      ':url' => Url::fromRoute('<front>')->setOption('base_url', $base_url)
        ->toString(TRUE)
        ->getGeneratedUrl(),
    ]) . ' ' . $log_message . '</p>';
  }
  else {
    $last = $session->get('updates_remaining');
    $last = reset($last);
    [
      $module,
      $version,
    ] = array_pop($last);
    $message = '<p class="error">' . $this->t('The update process was aborted prematurely while running <strong>update #@version in @module.module</strong>.', [
      '@version' => $version,
      '@module' => $module,
    ]) . ' ' . $log_message;
    if ($dblog_exists) {
      $message .= ' ' . $this->t('You may need to check the <code>watchdog</code> database table manually.');
    }
    $message .= '</p>';
  }
  if (Settings::get('update_free_access')) {
    $message .= '<p>' . $this->t("<strong>Reminder: don't forget to set the <code>\$settings['update_free_access']</code> value in your <code>settings.php</code> file back to <code>FALSE</code>.</strong>") . '</p>';
  }
  $build['message'] = [
    '#markup' => $message,
  ];
  $build['links'] = [
    '#theme' => 'links',
    '#links' => $this->helpfulLinks($request),
  ];
  // Output a list of info messages.
  if (!empty($update_results)) {
    $all_messages = [];
    foreach ($update_results as $extension => $updates) {
      if ($extension != '#abort') {
        $extension_has_message = FALSE;
        $info_messages = [];
        foreach ($updates as $name => $queries) {
          $messages = [];
          foreach ($queries as $query) {
            // If there is no message for this update, don't show anything.
            if (empty($query['query'])) {
              continue;
            }
            if ($query['success']) {
              $messages[] = [
                '#wrapper_attributes' => [
                  'class' => [
                    'success',
                  ],
                ],
                '#markup' => $query['query'],
              ];
            }
            else {
              $messages[] = [
                '#wrapper_attributes' => [
                  'class' => [
                    'failure',
                  ],
                ],
                '#markup' => '<strong>' . $this->t('Failed:') . '</strong> ' . $query['query'],
              ];
            }
          }
          if ($messages) {
            $extension_has_message = TRUE;
            if (is_numeric($name)) {
              $title = $this->t('Update #@count', [
                '@count' => $name,
              ]);
            }
            else {
              $title = $this->t('Update @name', [
                '@name' => trim($name, '_'),
              ]);
            }
            $info_messages[] = [
              '#theme' => 'item_list',
              '#items' => $messages,
              '#title' => $title,
            ];
          }
        }
        // If there were any messages then prefix them with the extension name
        // and add it to the global message list.
        if ($extension_has_message) {
          $header = $this->moduleHandler
            ->moduleExists($extension) ? $this->t('@module module', [
            '@module' => $extension,
          ]) : $this->t('@theme theme', [
            '@theme' => $extension,
          ]);
          $all_messages[] = [
            '#type' => 'container',
            '#prefix' => '<h3>' . $header . '</h3>',
            '#children' => $info_messages,
          ];
        }
      }
    }
    if ($all_messages) {
      $build['query_messages'] = [
        '#type' => 'container',
        '#children' => $all_messages,
        '#attributes' => [
          'class' => [
            'update-results',
          ],
        ],
        '#prefix' => '<h2>' . $this->t('The following updates returned messages:') . '</h2>',
      ];
    }
  }
  return $build;
}

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