class UpdateController

Same name in other branches
  1. 9 core/modules/update/src/Controller/UpdateController.php \Drupal\update\Controller\UpdateController
  2. 8.9.x core/modules/update/src/Controller/UpdateController.php \Drupal\update\Controller\UpdateController
  3. 11.x core/modules/update/src/Controller/UpdateController.php \Drupal\update\Controller\UpdateController

Controller routines for update routes.

Hierarchy

Expanded class hierarchy of UpdateController

File

core/modules/update/src/Controller/UpdateController.php, line 18

Namespace

Drupal\update\Controller
View source
class UpdateController extends ControllerBase {
    
    /**
     * Update manager service.
     *
     * @var \Drupal\update\UpdateManagerInterface
     */
    protected $updateManager;
    
    /**
     * The renderer.
     *
     * @var \Drupal\Core\Render\RendererInterface
     */
    protected $renderer;
    
    /**
     * Constructs update status data.
     *
     * @param \Drupal\update\UpdateManagerInterface $update_manager
     *   Update Manager Service.
     * @param \Drupal\Core\Render\RendererInterface $renderer
     *   The renderer.
     */
    public function __construct(UpdateManagerInterface $update_manager, RendererInterface $renderer) {
        $this->updateManager = $update_manager;
        $this->renderer = $renderer;
    }
    
    /**
     * Returns a page about the update status of projects.
     *
     * @return array
     *   A build array with the update status of projects.
     */
    public function updateStatus() {
        $build = [
            '#theme' => 'update_report',
        ];
        if ($available = update_get_available(TRUE)) {
            $this->moduleHandler()
                ->loadInclude('update', 'compare.inc');
            $build['#data'] = update_calculate_project_data($available);
            // @todo Consider using 'fetch_failures' from the 'update' collection
            // in the key_value_expire service for this?
            $fetch_failed = FALSE;
            foreach ($build['#data'] as $project) {
                if ($project['status'] === UpdateFetcherInterface::NOT_FETCHED) {
                    $fetch_failed = TRUE;
                    break;
                }
            }
            if ($fetch_failed) {
                $message = [
                    '#theme' => 'update_fetch_error_message',
                ];
                $this->messenger()
                    ->addError($this->renderer
                    ->renderInIsolation($message));
            }
        }
        return $build;
    }
    
    /**
     * Manually checks the update status without the use of cron.
     */
    public function updateStatusManually() {
        $this->updateManager
            ->refreshUpdateData();
        $batch_builder = (new BatchBuilder())->setTitle($this->t('Checking available update data'))
            ->addOperation([
            $this->updateManager,
            'fetchDataBatch',
        ], [])
            ->setProgressMessage(t('Trying to check available update data ...'))
            ->setErrorMessage($this->t('Error checking available update data.'))
            ->setFinishCallback('update_fetch_data_finished');
        batch_set($batch_builder->toArray());
        return batch_process('admin/reports/updates');
    }
    
    /**
     * Provides a redirect to update page.
     *
     * @param \Drupal\Core\Routing\RouteMatchInterface $route_match
     *   A route match object, used for the route name and the parameters.
     * @param \Symfony\Component\HttpFoundation\Request $request
     *   The current request object.
     *
     * @return \Symfony\Component\HttpFoundation\RedirectResponse
     *   Returns redirect.
     *
     * @deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Use
     *   /admin/appearance/update directly instead of /admin/theme/update.
     *
     * @see https://www.drupal.org/node/3375850
     */
    public function updateRedirect(RouteMatchInterface $route_match, Request $request) : RedirectResponse {
        @trigger_error('The path /admin/theme/update is deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Use /admin/appearance/update. See https://www.drupal.org/node/3382805', E_USER_DEPRECATED);
        $helper = new PathChangedHelper($route_match, $request);
        $params = [
            '%old_path' => $helper->oldPath(),
            '%new_path' => $helper->newPath(),
            '%change_record' => 'https://www.drupal.org/node/3382805',
        ];
        $warning_message = $this->t('You have been redirected from %old_path. Update links, shortcuts, and bookmarks to use %new_path.', $params);
        $this->messenger()
            ->addWarning($warning_message);
        $this->getLogger('update')
            ->warning('A user was redirected from %old_path to %new_path. This redirect will be removed in a future version of Drupal. Update links, shortcuts, and bookmarks to use %new_path. See %change_record for more information.', $params);
        return $helper->redirect();
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overrides
AutowireTrait::create public static function Instantiates a new instance of the implementing class using autowiring. 33
ControllerBase::$configFactory protected property The configuration factory.
ControllerBase::$currentUser protected property The current user service. 2
ControllerBase::$entityFormBuilder protected property The entity form builder.
ControllerBase::$entityTypeManager protected property The entity type manager.
ControllerBase::$formBuilder protected property The form builder. 1
ControllerBase::$keyValue protected property The key-value storage. 1
ControllerBase::$languageManager protected property The language manager. 1
ControllerBase::$moduleHandler protected property The module handler. 1
ControllerBase::$stateService protected property The state service.
ControllerBase::cache protected function Returns the requested cache bin.
ControllerBase::config protected function Retrieves a configuration object.
ControllerBase::container private function Returns the service container.
ControllerBase::currentUser protected function Returns the current user. 2
ControllerBase::entityFormBuilder protected function Retrieves the entity form builder.
ControllerBase::entityTypeManager protected function Retrieves the entity type manager.
ControllerBase::formBuilder protected function Returns the form builder service. 1
ControllerBase::keyValue protected function Returns a key/value storage collection. 1
ControllerBase::languageManager protected function Returns the language manager service. 1
ControllerBase::moduleHandler protected function Returns the module handler. 1
ControllerBase::redirect protected function Returns a redirect response object for the specified route.
ControllerBase::state protected function Returns the state storage service.
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 16
MessengerTrait::messenger public function Gets the messenger. 16
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 2
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.
UpdateController::$renderer protected property The renderer.
UpdateController::$updateManager protected property Update manager service.
UpdateController::updateRedirect Deprecated public function Provides a redirect to update page.
UpdateController::updateStatus public function Returns a page about the update status of projects.
UpdateController::updateStatusManually public function Manually checks the update status without the use of cron.
UpdateController::__construct public function Constructs update status data.

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