function ConfigDependencyTest::testConfigEntityUninstallComplex

Same name in other branches
  1. 9 core/tests/Drupal/KernelTests/Core/Config/ConfigDependencyTest.php \Drupal\KernelTests\Core\Config\ConfigDependencyTest::testConfigEntityUninstallComplex()
  2. 8.9.x core/tests/Drupal/KernelTests/Core/Config/ConfigDependencyTest.php \Drupal\KernelTests\Core\Config\ConfigDependencyTest::testConfigEntityUninstallComplex()
  3. 10 core/tests/Drupal/KernelTests/Core/Config/ConfigDependencyTest.php \Drupal\KernelTests\Core\Config\ConfigDependencyTest::testConfigEntityUninstallComplex()

Tests complex configuration entity dependency handling during uninstall.

Configuration entities can be deleted or updated during module uninstall because they have dependencies on the module.

@dataProvider providerConfigEntityUninstallComplex

Parameters

array $entity_id_suffixes: The suffixes to add to the 4 entities created by the test.

File

core/tests/Drupal/KernelTests/Core/Config/ConfigDependencyTest.php, line 253

Class

ConfigDependencyTest
Tests for configuration dependencies.

Namespace

Drupal\KernelTests\Core\Config

Code

public function testConfigEntityUninstallComplex(array $entity_id_suffixes) : void {
    
    /** @var \Drupal\Core\Config\ConfigManagerInterface $config_manager */
    $config_manager = \Drupal::service('config.manager');
    
    /** @var \Drupal\Core\Config\Entity\ConfigEntityStorage $storage */
    $storage = $this->container
        ->get('entity_type.manager')
        ->getStorage('config_test');
    // Entity 1 will be deleted because it depends on node.
    $entity_1 = $storage->create([
        'id' => 'entity_' . $entity_id_suffixes[0],
        'dependencies' => [
            'enforced' => [
                'module' => [
                    'node',
                    'config_test',
                ],
            ],
        ],
    ]);
    $entity_1->save();
    // Entity 2 has a dependency on entity 1 but it can be fixed because
    // \Drupal\config_test\Entity::onDependencyRemoval() will remove the
    // dependency before config entities are deleted.
    $entity_2 = $storage->create([
        'id' => 'entity_' . $entity_id_suffixes[1],
        'dependencies' => [
            'enforced' => [
                'config' => [
                    $entity_1->getConfigDependencyName(),
                ],
            ],
        ],
    ]);
    $entity_2->save();
    // Entity 3 will be unchanged because it is dependent on entity 2 which can
    // be fixed. The ConfigEntityInterface::onDependencyRemoval() method will
    // not be called for this entity.
    $entity_3 = $storage->create([
        'id' => 'entity_' . $entity_id_suffixes[2],
        'dependencies' => [
            'enforced' => [
                'config' => [
                    $entity_2->getConfigDependencyName(),
                ],
            ],
        ],
    ]);
    $entity_3->save();
    // Entity 4's config dependency will be fixed but it will still be deleted
    // because it also depends on the node module.
    $entity_4 = $storage->create([
        'id' => 'entity_' . $entity_id_suffixes[3],
        'dependencies' => [
            'enforced' => [
                'config' => [
                    $entity_1->getConfigDependencyName(),
                ],
                'module' => [
                    'node',
                    'config_test',
                ],
            ],
        ],
    ]);
    $entity_4->save();
    // Entity 5 will be fixed because it is dependent on entity 3, which is
    // unchanged, and entity 1 which will be fixed because
    // \Drupal\config_test\Entity::onDependencyRemoval() will remove the
    // dependency.
    $entity_5 = $storage->create([
        'id' => 'entity_' . $entity_id_suffixes[4],
        'dependencies' => [
            'enforced' => [
                'config' => [
                    $entity_1->getConfigDependencyName(),
                    $entity_3->getConfigDependencyName(),
                ],
            ],
        ],
    ]);
    $entity_5->save();
    // Set a more complicated test where dependencies will be fixed.
    \Drupal::state()->set('config_test.fix_dependencies', [
        $entity_1->getConfigDependencyName(),
    ]);
    \Drupal::state()->set('config_test.on_dependency_removal_called', []);
    // Do a dry run using
    // \Drupal\Core\Config\ConfigManager::getConfigEntitiesToChangeOnDependencyRemoval().
    $config_entities = $config_manager->getConfigEntitiesToChangeOnDependencyRemoval('module', [
        'node',
    ]);
    // Assert that \Drupal\config_test\Entity\ConfigTest::onDependencyRemoval()
    // is called as expected and with the correct dependencies.
    $called = \Drupal::state()->get('config_test.on_dependency_removal_called', []);
    $this->assertArrayNotHasKey($entity_3->id(), $called, 'ConfigEntityInterface::onDependencyRemoval() is not called for entity 3.');
    $this->assertSame([
        $entity_1->id(),
        $entity_4->id(),
        $entity_2->id(),
        $entity_5->id(),
    ], array_keys($called), 'The most dependent entities have ConfigEntityInterface::onDependencyRemoval() called first.');
    $this->assertSame([
        'config' => [],
        'content' => [],
        'module' => [
            'node',
        ],
        'theme' => [],
    ], $called[$entity_1->id()]);
    $this->assertSame([
        'config' => [
            $entity_1->getConfigDependencyName(),
        ],
        'content' => [],
        'module' => [],
        'theme' => [],
    ], $called[$entity_2->id()]);
    $this->assertSame([
        'config' => [
            $entity_1->getConfigDependencyName(),
        ],
        'content' => [],
        'module' => [
            'node',
        ],
        'theme' => [],
    ], $called[$entity_4->id()]);
    $this->assertSame([
        'config' => [
            $entity_1->getConfigDependencyName(),
        ],
        'content' => [],
        'module' => [],
        'theme' => [],
    ], $called[$entity_5->id()]);
    $this->assertEquals($entity_1->uuid(), $config_entities['delete'][1]->uuid(), 'Entity 1 will be deleted.');
    $this->assertEquals($entity_2->uuid(), $config_entities['update'][0]->uuid(), 'Entity 2 will be updated.');
    $this->assertEquals($entity_3->uuid(), reset($config_entities['unchanged'])->uuid(), 'Entity 3 is not changed.');
    $this->assertEquals($entity_4->uuid(), $config_entities['delete'][0]->uuid(), 'Entity 4 will be deleted.');
    $this->assertEquals($entity_5->uuid(), $config_entities['update'][1]->uuid(), 'Entity 5 is updated.');
    // Perform the uninstall.
    $config_manager->uninstall('module', 'node');
    // Test that expected actions have been performed.
    $this->assertNull($storage->load($entity_1->id()), 'Entity 1 deleted');
    $entity_2 = $storage->load($entity_2->id());
    $this->assertNotEmpty($entity_2, 'Entity 2 not deleted');
    $this->assertEquals([], $entity_2->calculateDependencies()
        ->getDependencies()['config'], 'Entity 2 dependencies updated to remove dependency on entity 1.');
    $entity_3 = $storage->load($entity_3->id());
    $this->assertNotEmpty($entity_3, 'Entity 3 not deleted');
    $this->assertEquals([
        $entity_2->getConfigDependencyName(),
    ], $entity_3->calculateDependencies()
        ->getDependencies()['config'], 'Entity 3 still depends on entity 2.');
    $this->assertNull($storage->load($entity_4->id()), 'Entity 4 deleted');
}

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