trait StorageCopyTrait

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Config/StorageCopyTrait.php \Drupal\Core\Config\StorageCopyTrait
  2. 10 core/lib/Drupal/Core/Config/StorageCopyTrait.php \Drupal\Core\Config\StorageCopyTrait
  3. 11.x core/lib/Drupal/Core/Config/StorageCopyTrait.php \Drupal\Core\Config\StorageCopyTrait

Utility trait to copy configuration from one storage to another.

Hierarchy

3 files declare their use of StorageCopyTrait
ConfigTestTrait.php in core/tests/Drupal/Tests/ConfigTestTrait.php
ReadOnlyStorageTest.php in core/tests/Drupal/Tests/Core/Config/ReadOnlyStorageTest.php
StorageCopyTraitTest.php in core/tests/Drupal/Tests/Core/Config/StorageCopyTraitTest.php

File

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

Namespace

Drupal\Core\Config
View source
trait StorageCopyTrait {
    
    /**
     * Copy the configuration from one storage to another and remove stale items.
     *
     * This method empties target storage and copies all collections from source.
     * Configuration is only copied and not imported, should not be used
     * with the active storage as the target.
     *
     * @param \Drupal\Core\Config\StorageInterface $source
     *   The configuration storage to copy from.
     * @param \Drupal\Core\Config\StorageInterface $target
     *   The configuration storage to copy to.
     */
    protected static function replaceStorageContents(StorageInterface $source, StorageInterface &$target) {
        // Remove all collections from the target which are not in the source.
        foreach (array_diff($target->getAllCollectionNames(), $source->getAllCollectionNames()) as $collection) {
            // We do this first so we don't have to loop over the added collections.
            $target->createCollection($collection)
                ->deleteAll();
        }
        // Copy all the configuration from all the collections.
        foreach (array_merge([
            StorageInterface::DEFAULT_COLLECTION,
        ], $source->getAllCollectionNames()) as $collection) {
            $source_collection = $source->createCollection($collection);
            $target_collection = $target->createCollection($collection);
            $names = $source_collection->listAll();
            // First we delete all the config which shouldn't be in the target.
            foreach (array_diff($target_collection->listAll(), $names) as $name) {
                $target_collection->delete($name);
            }
            // Then we loop over the config which needs to be there.
            foreach ($names as $name) {
                $data = $source_collection->read($name);
                if ($data !== FALSE) {
                    if ($target_collection->read($name) !== $data) {
                        // Update the target collection if the data is different.
                        $target_collection->write($name, $data);
                    }
                }
                else {
                    $target_collection->delete($name);
                    \Drupal::logger('config')->notice('Missing required data for configuration: %config', [
                        '%config' => $name,
                    ]);
                }
            }
        }
        // Make sure that the target is set to the same collection as the source.
        $target = $target->createCollection($source->getCollectionName());
    }

}

Members

Title Sort descending Modifiers Object type Summary
StorageCopyTrait::replaceStorageContents protected static function Copy the configuration from one storage to another and remove stale items.

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