SystemConfigSubscriber.php

Same filename and directory in other branches
  1. 9 core/modules/system/src/SystemConfigSubscriber.php
  2. 8.9.x core/modules/system/src/SystemConfigSubscriber.php
  3. 10 core/modules/system/src/SystemConfigSubscriber.php

Namespace

Drupal\system

File

core/modules/system/src/SystemConfigSubscriber.php

View source
<?php

namespace Drupal\system;

use Drupal\Core\Config\ConfigCrudEvent;
use Drupal\Core\Config\ConfigEvents;
use Drupal\Core\Config\ConfigImporterEvent;
use Drupal\Core\Routing\RouteBuilderInterface;
use Drupal\Core\StringTranslation\StringTranslationTrait;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

/**
 * System Config subscriber.
 */
class SystemConfigSubscriber implements EventSubscriberInterface {
  use StringTranslationTrait;
  
  /**
   * The router builder.
   *
   * @var \Drupal\Core\Routing\RouteBuilderInterface
   */
  protected $routerBuilder;
  
  /**
   * Constructs the SystemConfigSubscriber.
   *
   * @param \Drupal\Core\Routing\RouteBuilderInterface $router_builder
   *   The router builder service.
   */
  public function __construct(RouteBuilderInterface $router_builder) {
    $this->routerBuilder = $router_builder;
  }
  
  /**
   * Rebuilds the router when the default or admin theme is changed.
   *
   * @param \Drupal\Core\Config\ConfigCrudEvent $event
   *   The configuration event.
   */
  public function onConfigSave(ConfigCrudEvent $event) {
    $saved_config = $event->getConfig();
    if ($saved_config->getName() == 'system.theme' && ($event->isChanged('admin') || $event->isChanged('default'))) {
      $this->routerBuilder
        ->setRebuildNeeded();
    }
  }
  
  /**
   * Checks that the configuration synchronization is valid.
   *
   * This event listener prevents deleting all configuration. If there is
   * nothing to import then event propagation is stopped because there is no
   * config import to validate.
   *
   * @param \Drupal\Core\Config\ConfigImporterEvent $event
   *   The config import event.
   */
  public function onConfigImporterValidateNotEmpty(ConfigImporterEvent $event) {
    $importList = $event->getConfigImporter()
      ->getStorageComparer()
      ->getSourceStorage()
      ->listAll();
    if (empty($importList)) {
      $event->getConfigImporter()
        ->logError($this->t('This import is empty and if applied would delete all of your configuration, so has been rejected.'));
      $event->stopPropagation();
    }
  }
  
  /**
   * Checks that the configuration synchronization is valid.
   *
   * This event listener checks that the system.site:uuid's in the source and
   * target match.
   *
   * @param \Drupal\Core\Config\ConfigImporterEvent $event
   *   The config import event.
   */
  public function onConfigImporterValidateSiteUUID(ConfigImporterEvent $event) {
    if (!$event->getConfigImporter()
      ->getStorageComparer()
      ->getSourceStorage()
      ->exists('system.site')) {
      $event->getConfigImporter()
        ->logError($this->t('This import does not contain system.site configuration, so has been rejected.'));
    }
    if (!$event->getConfigImporter()
      ->getStorageComparer()
      ->validateSiteUuid()) {
      $event->getConfigImporter()
        ->logError($this->t('Site UUID in source storage does not match the target storage.'));
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public static function getSubscribedEvents() : array {
    $events[ConfigEvents::SAVE][] = [
      'onConfigSave',
      0,
    ];
    // The empty check has a high priority so that it can stop propagation if
    // there is no configuration to import.
    $events[ConfigEvents::IMPORT_VALIDATE][] = [
      'onConfigImporterValidateNotEmpty',
      512,
    ];
    $events[ConfigEvents::IMPORT_VALIDATE][] = [
      'onConfigImporterValidateSiteUUID',
      256,
    ];
    return $events;
  }

}

Classes

Title Deprecated Summary
SystemConfigSubscriber System Config subscriber.

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