class ConfigCollectionEvents

Defines events for working with configuration collections.

Configuration collections are often used to store configuration-related data, like overrides. The use case is determined by the module that provides the collection. A classic example is to store the translated parts of various configuration objects. Using a collection allows this data to be imported and exported alongside regular configuration. It also allows the data to be created when installing an extension. In both the import/export and extension installation situations, collection data is stored in subdirectories.

Hierarchy

Expanded class hierarchy of ConfigCollectionEvents

See also

\Drupal\Core\Config\ConfigCrudEvent

8 files declare their use of ConfigCollectionEvents
CheckpointStorage.php in core/lib/Drupal/Core/Config/Checkpoint/CheckpointStorage.php
ConfigImporterTest.php in core/tests/Drupal/KernelTests/Core/Config/ConfigImporterTest.php
ConfigInstallTest.php in core/tests/Drupal/KernelTests/Core/Config/ConfigInstallTest.php
EventSubscriber.php in core/modules/config/tests/config_collection_install_test/src/EventSubscriber.php
EventSubscriber.php in core/modules/config/tests/config_events_test/src/EventSubscriber.php

... See full list

File

View on git.drupalcode.org

core/lib/Drupal/Core/Config/ConfigCollectionEvents.php, line 19

Namespace

Drupal\Core\Config
View source 
final class ConfigCollectionEvents {
  
  /**
   * Event dispatched when saving configuration not in the default collection.
   *
   * This event allows modules to react whenever an object that extends
   * \Drupal\Core\Config\StorableConfigBase is saved in a non-default
   * collection. The event listener method receives a
   * \Drupal\Core\Config\ConfigCrudEvent instance.
   *
   * Note: this event is not used for configuration in the default collection.
   * See \Drupal\Core\Config\ConfigEvents::SAVE instead.
   *
   * @Event
   *
   * @var string
   *
   * @see \Drupal\Core\Config\ConfigCrudEvent
   * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
   * @see \Drupal\language\Config\LanguageConfigOverride::save()
   *
   * @see \Drupal\Core\Config\ConfigEvents::SAVE
   */
  const SAVE_IN_COLLECTION = 'config.save.collection';
  
  /**
   * Event dispatched when deleting configuration not in the default collection.
   *
   * This event allows modules to react whenever an object that extends
   * \Drupal\Core\Config\StorableConfigBase is deleted in a non-default
   * collection. The event listener method receives a
   * \Drupal\Core\Config\ConfigCrudEvent instance.
   *
   * Note: this event is not used for configuration in the default collection.
   * See \Drupal\Core\Config\ConfigEvents::DELETE instead.
   *
   * @Event
   *
   * @see \Drupal\Core\Config\ConfigEvents::DELETE
   * @see \Drupal\Core\Config\ConfigCrudEvent
   * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
   * @see \Drupal\language\Config\LanguageConfigOverride::delete()
   *
   * @var string
   */
  const DELETE_IN_COLLECTION = 'config.delete.collection';
  
  /**
   * Event dispatched when renaming configuration not in the default collection.
   *
   * This event allows modules to react whenever an object that extends
   * \Drupal\Core\Config\StorableConfigBase is renamed in a non-default
   * collection. The event listener method receives a
   * \Drupal\Core\Config\ConfigCrudEvent instance.
   *
   * Note: this event is not used for configuration in the default collection.
   * See \Drupal\Core\Config\ConfigEvents::RENAME instead.
   *
   * @Event
   *
   * @see \Drupal\Core\Config\ConfigEvents::RENAME
   * @see \Drupal\Core\Config\ConfigCrudEvent
   * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
   *
   * @var string
   */
  const RENAME_IN_COLLECTION = 'config.rename.collection';
  
  /**
   * Event dispatched to collect information on all config collections.
   *
   * This event allows modules to add to the list of configuration collections
   * retrieved by \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo().
   * The event listener method receives a
   * \Drupal\Core\Config\ConfigCollectionInfo instance.
   *
   * @Event
   *
   * @see \Drupal\Core\Config\ConfigCollectionInfo
   * @see \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo()
   * @see \Drupal\Core\Config\ConfigFactoryOverrideBase
   *
   * @var string
   */
  const COLLECTION_INFO = 'config.collection_info';

}

Members

Title Modifiers Object type Summary
ConfigCollectionEvents::COLLECTION_INFO constant Event dispatched to collect information on all config collections.
ConfigCollectionEvents::DELETE_IN_COLLECTION constant Event dispatched when deleting configuration not in the default collection.
ConfigCollectionEvents::RENAME_IN_COLLECTION constant Event dispatched when renaming configuration not in the default collection.
ConfigCollectionEvents::SAVE_IN_COLLECTION constant Event dispatched when saving configuration not in the default collection.

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