interface ConfigManagerInterface in Drupal 9

Provides an interface for configuration manager.

Hierarchy

• interface \Drupal\Core\Config\ConfigManagerInterface

13 files declare their use of ConfigManagerInterface

BundleConfigImportValidate.php in core/lib/Drupal/Core/Entity/Event/BundleConfigImportValidate.php

ConfigController.php in core/modules/config/src/Controller/ConfigController.php

ConfigDependencyDeleteFormTrait.php in core/lib/Drupal/Core/Config/Entity/ConfigDependencyDeleteFormTrait.php

ConfigEntityStorageTest.php in core/tests/Drupal/Tests/Core/Config/Entity/ConfigEntityStorageTest.php

ConfigImportSubscriber.php in core/modules/content_moderation/src/EventSubscriber/ConfigImportSubscriber.php

... See full list

File

core/lib/Drupal/Core/Config/ConfigManagerInterface.php, line 8

Namespace

Drupal\Core\Config

interface ConfigManagerInterface {

  /**
   * Returns the entity type of a configuration object.
   *
   * @param string $name
   *   The configuration object name.
   *
   * @return string|null
   *   Either the entity type name, or NULL if none match.
   */
  public function getEntityTypeIdByName($name);

  /**
   * Loads a configuration entity using the configuration name.
   *
   * @param string $name
   *   The configuration object name.
   *
   * @return \Drupal\Core\Entity\EntityInterface|null
   *   The configuration entity or NULL if it does not exist.
   */
  public function loadConfigEntityByName($name);

  /**
   * Gets the entity type manager.
   *
   * @return \Drupal\Core\Entity\EntityTypeManagerInterface
   *   The entity type manager.
   */
  public function getEntityTypeManager();

  /**
   * Gets the config factory.
   *
   * @return \Drupal\Core\Config\ConfigFactoryInterface
   *   The config factory.
   */
  public function getConfigFactory();

  /**
   * Creates a Diff object using the config data from the two storages.
   *
   * @param \Drupal\Core\Config\StorageInterface $source_storage
   *   The storage to diff configuration from.
   * @param \Drupal\Core\Config\StorageInterface $target_storage
   *   The storage to diff configuration to.
   * @param string $source_name
   *   The name of the configuration object in the source storage to diff.
   * @param string $target_name
   *   (optional) The name of the configuration object in the target storage.
   *   If omitted, the source name is used.
   * @param string $collection
   *   (optional) The configuration collection name. Defaults to the default
   *   collection.
   *
   * @return \Drupal\Component\Diff\Diff
   *   A Diff object using the config data from the two storages.
   *
   * @todo Make renderer injectable
   *
   * @see \Drupal\Core\Diff\DiffFormatter
   */
  public function diff(StorageInterface $source_storage, StorageInterface $target_storage, $source_name, $target_name = NULL, $collection = StorageInterface::DEFAULT_COLLECTION);

  /**
   * Creates a configuration snapshot following a successful import.
   *
   * @param \Drupal\Core\Config\StorageInterface $source_storage
   *   The storage to synchronize configuration from.
   * @param \Drupal\Core\Config\StorageInterface $snapshot_storage
   *   The storage to synchronize configuration to.
   */
  public function createSnapshot(StorageInterface $source_storage, StorageInterface $snapshot_storage);

  /**
   * Uninstalls the configuration of a given extension.
   *
   * @param string $type
   *   The extension type; e.g., 'module' or 'theme'.
   * @param string $name
   *   The name of the module or theme to install configuration for.
   */
  public function uninstall($type, $name);

  /**
   * Creates and populates a ConfigDependencyManager object.
   *
   * The configuration dependency manager is populated with data from the active
   * store.
   *
   * @return \Drupal\Core\Config\Entity\ConfigDependencyManager
   */
  public function getConfigDependencyManager();

  /**
   * Finds config entities that are dependent on extensions or entities.
   *
   * @param string $type
   *   The type of dependency being checked. Either 'module', 'theme', 'config'
   *   or 'content'.
   * @param array $names
   *   The specific names to check. If $type equals 'module' or 'theme' then it
   *   should be a list of module names or theme names. In the case of 'config'
   *   or 'content' it should be a list of configuration dependency names.
   *
   * @return \Drupal\Core\Config\Entity\ConfigEntityDependency[]
   *   An array of configuration entity dependency objects.
   */
  public function findConfigEntityDependencies($type, array $names);

  /**
   * Finds config entities that are dependent on extensions or entities.
   *
   * @param string $type
   *   The type of dependency being checked. Either 'module', 'theme', 'config'
   *   or 'content'.
   * @param array $names
   *   The specific names to check. If $type equals 'module' or 'theme' then it
   *   should be a list of module names or theme names. In the case of 'config'
   *   or 'content' it should be a list of configuration dependency names.
   *
   * @return \Drupal\Core\Config\Entity\ConfigEntityInterface[]
   *   An array of dependencies as configuration entities.
   */
  public function findConfigEntityDependenciesAsEntities($type, array $names);

  /**
   * Deprecated method to find config entity dependencies.
   *
   * @param string $type
   *   The type of dependency being checked. Either 'module', 'theme', 'config'
   *   or 'content'.
   * @param array $names
   *   The specific names to check. If $type equals 'module' or 'theme' then it
   *   should be a list of module names or theme names. In the case of 'config'
   *   or 'content' it should be a list of configuration dependency names.
   *
   * @return \Drupal\Core\Config\Entity\ConfigEntityDependency[]
   *   An array of configuration entity dependency objects.
   *
   * @deprecated in drupal:9.3.0 and is removed from drupal:10.0.0.
   *   Instead you should use
   *   ConfigManagerInterface::findConfigEntityDependencies().
   * @see https://www.drupal.org/node/3225357
   */
  public function findConfigEntityDependents($type, array $names);

  /**
   * Deprecated method to find config entity dependencies as entities.
   *
   * @param string $type
   *   The type of dependency being checked. Either 'module', 'theme', 'config'
   *   or 'content'.
   * @param array $names
   *   The specific names to check. If $type equals 'module' or 'theme' then it
   *   should be a list of module names or theme names. In the case of 'config'
   *   or 'content' it should be a list of configuration dependency names.
   *
   * @return \Drupal\Core\Config\Entity\ConfigEntityInterface[]
   *   An array of dependencies as configuration entities.
   *
   * @deprecated in drupal:9.3.0 and is removed from drupal:10.0.0.
   *   Instead you should use
   *   ConfigManagerInterface::findConfigEntityDependenciesAsEntities().
   * @see https://www.drupal.org/node/3225357
   */
  public function findConfigEntityDependentsAsEntities($type, array $names);

  /**
   * Lists which config entities to update and delete on removal of a dependency.
   *
   * @param string $type
   *   The type of dependency being checked. Either 'module', 'theme', 'config'
   *   or 'content'.
   * @param array $names
   *   The specific names to check. If $type equals 'module' or 'theme' then it
   *   should be a list of module names or theme names. In the case of 'config'
   *   or 'content' it should be a list of configuration dependency names.
   * @param bool $dry_run
   *   If set to FALSE the entities returned in the list of updates will be
   *   modified. In order to make the changes the caller needs to save them. If
   *   set to TRUE the entities returned will not be modified.
   *
   * @return array
   *   An array with the keys: 'update', 'delete' and 'unchanged'. The value of
   *   each is a list of configuration entities that need to have that action
   *   applied when the supplied dependencies are removed. Updates need to be
   *   processed before deletes. The order of the deletes is significant and
   *   must be processed in the returned order.
   */
  public function getConfigEntitiesToChangeOnDependencyRemoval($type, array $names, $dry_run = TRUE);

  /**
   * Gets available collection information using the event system.
   *
   * @return \Drupal\Core\Config\ConfigCollectionInfo
   *   The object which contains information about the available collections.
   */
  public function getConfigCollectionInfo();

  /**
   * Finds missing content dependencies declared in configuration entities.
   *
   * @return array
   *   A list of missing content dependencies. The array is keyed by UUID. Each
   *   value is an array with the following keys: 'entity_type', 'bundle' and
   *   'uuid'.
   */
  public function findMissingContentDependencies();

}

Members

Name	Modifiers	Type	Description	Overrides
ConfigManagerInterface::createSnapshot	public	function	Creates a configuration snapshot following a successful import.	1
ConfigManagerInterface::diff	public	function	Creates a Diff object using the config data from the two storages.	1
ConfigManagerInterface::findConfigEntityDependencies	public	function	Finds config entities that are dependent on extensions or entities.	1
ConfigManagerInterface::findConfigEntityDependenciesAsEntities	public	function	Finds config entities that are dependent on extensions or entities.	1
ConfigManagerInterface::findConfigEntityDependents Deprecated	public	function	Deprecated method to find config entity dependencies.	1
ConfigManagerInterface::findConfigEntityDependentsAsEntities Deprecated	public	function	Deprecated method to find config entity dependencies as entities.	1
ConfigManagerInterface::findMissingContentDependencies	public	function	Finds missing content dependencies declared in configuration entities.	1
ConfigManagerInterface::getConfigCollectionInfo	public	function	Gets available collection information using the event system.	1
ConfigManagerInterface::getConfigDependencyManager	public	function	Creates and populates a ConfigDependencyManager object.	1
ConfigManagerInterface::getConfigEntitiesToChangeOnDependencyRemoval	public	function	Lists which config entities to update and delete on removal of a dependency.	1
ConfigManagerInterface::getConfigFactory	public	function	Gets the config factory.	1
ConfigManagerInterface::getEntityTypeIdByName	public	function	Returns the entity type of a configuration object.	1
ConfigManagerInterface::getEntityTypeManager	public	function	Gets the entity type manager.	1
ConfigManagerInterface::loadConfigEntityByName	public	function	Loads a configuration entity using the configuration name.	1
ConfigManagerInterface::uninstall	public	function	Uninstalls the configuration of a given extension.	1