interface ConfigManagerInterface

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Config/ConfigManagerInterface.php \Drupal\Core\Config\ConfigManagerInterface
  2. 8.9.x core/lib/Drupal/Core/Config/ConfigManagerInterface.php \Drupal\Core\Config\ConfigManagerInterface
  3. 11.x core/lib/Drupal/Core/Config/ConfigManagerInterface.php \Drupal\Core\Config\ConfigManagerInterface

Provides an interface for configuration manager.

Hierarchy

Expanded class hierarchy of ConfigManagerInterface

All classes that implement ConfigManagerInterface

15 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
View source
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);
    
    /**
     * 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

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

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