function UpdateScriptTest::testMissingExtension

Same name in other branches
  1. 9 core/modules/system/tests/src/Functional/UpdateSystem/UpdateScriptTest.php \Drupal\Tests\system\Functional\UpdateSystem\UpdateScriptTest::testMissingExtension()
  2. 8.9.x core/modules/system/tests/src/Functional/UpdateSystem/UpdateScriptTest.php \Drupal\Tests\system\Functional\UpdateSystem\UpdateScriptTest::testMissingExtension()
  3. 10 core/modules/system/tests/src/Functional/UpdateSystem/UpdateScriptTest.php \Drupal\Tests\system\Functional\UpdateSystem\UpdateScriptTest::testMissingExtension()

Tests that a missing extension prevents updates.

@dataProvider providerMissingExtension

Parameters

array $core: An array keyed by 'module' and 'theme' where each sub array contains a list of extension machine names.

array $contrib: An array keyed by 'module' and 'theme' where each sub array contains a list of extension machine names.

File

core/modules/system/tests/src/Functional/UpdateSystem/UpdateScriptTest.php, line 352

Class

UpdateScriptTest
Tests the update script access and functionality.

Namespace

Drupal\Tests\system\Functional\UpdateSystem

Code

public function testMissingExtension(array $core, array $contrib) : void {
    $this->markTestSkipped('Skipped due to major version-specific logic. See https://www.drupal.org/project/drupal/issues/3359322');
    $this->drupalLogin($this->drupalCreateUser([
        'administer software updates',
        'administer site configuration',
        'administer modules',
        'administer themes',
    ]));
    $all_extensions_info = [];
    $file_paths = [];
    $test_error_texts = [];
    $test_error_urls = [];
    $extension_base_info = [
        'version' => 'VERSION',
        'core_version_requirement' => '^8 || ^9 || ^10',
    ];
    // For each core extension create and error of info.yml information and
    // the expected error message.
    foreach ($core as $type => $extensions) {
        $removed_list = [];
        $error_url = 'https://www.drupal.org/node/3223395#s-recommendations-for-deprecated-modules';
        $extension_base_info += [
            'package' => 'Core',
        ];
        if ($type === 'module') {
            $removed_core_list = \DRUPAL_CORE_REMOVED_MODULE_LIST;
        }
        else {
            $removed_core_list = \DRUPAL_CORE_REMOVED_THEME_LIST;
        }
        foreach ($extensions as $extension) {
            $extension_info = $extension_base_info + [
                'name' => "The magically disappearing core {$type} {$extension}",
                'type' => $type,
            ];
            if ($type === 'theme') {
                $extension_info['base theme'] = FALSE;
            }
            $all_extensions_info[$extension] = $extension_info;
            $removed_list[] = $removed_core_list[$extension];
        }
        // Create the requirements test message.
        if (!empty($extensions)) {
            $handbook_message = "For more information read the documentation on deprecated {$type}s.";
            if (count($removed_list) === 1) {
                $test_error_texts[$type][] = "Removed core {$type} " . "You must add the following contributed {$type} and reload this page." . implode($removed_list) . "This {$type} is installed on your site but is no longer provided by Core." . $handbook_message;
            }
            else {
                $test_error_texts[$type][] = "Removed core {$type}s " . "You must add the following contributed {$type}s and reload this page." . implode($removed_list) . "These {$type}s are installed on your site but are no longer provided by Core." . $handbook_message;
            }
            $test_error_urls[$type][] = $error_url;
        }
    }
    // For each contrib extension create and error of info.yml information and
    // the expected error message.
    foreach ($contrib as $type => $extensions) {
        unset($extension_base_info['package']);
        $handbook_message = 'Review the suggestions for resolving this incompatibility to repair your installation, and then re-run update.php.';
        $error_url = 'https://www.drupal.org/docs/updating-drupal/troubleshooting-database-updates';
        foreach ($extensions as $extension) {
            $extension_info = $extension_base_info + [
                'name' => "The magically disappearing contrib {$type} {$extension}",
                'type' => $type,
            ];
            if ($type === 'theme') {
                $extension_info['base theme'] = FALSE;
            }
            $all_extensions_info[$extension] = $extension_info;
        }
        // Create the requirements test message.
        if (!empty($extensions)) {
            if (count($extensions) === 1) {
                $test_error_texts[$type][] = "Missing or invalid {$type} " . "The following {$type} is marked as installed in the core.extension configuration, but it is missing:" . implode($extensions) . $handbook_message;
            }
            else {
                $test_error_texts[$type][] = "Missing or invalid {$type}s " . "The following {$type}s are marked as installed in the core.extension configuration, but they are missing:" . implode($extensions) . $handbook_message;
            }
            $test_error_urls[$type][] = $error_url;
        }
    }
    // Create the info.yml files for each extension.
    foreach ($all_extensions_info as $machine_name => $extension_info) {
        $type = $extension_info['type'];
        $folder_path = \Drupal::getContainer()->getParameter('site.path') . "/{$type}s/contrib/{$machine_name}";
        $file_path = "{$folder_path}/{$machine_name}.info.yml";
        mkdir($folder_path, 0777, TRUE);
        file_put_contents($file_path, Yaml::encode($extension_info));
        $file_paths[$machine_name] = $file_path;
    }
    // Enable all the extensions.
    foreach ($all_extensions_info as $machine_name => $extension_info) {
        $extension_machine_names = [
            $machine_name,
        ];
        $extension_names = [
            $extension_info['name'],
        ];
        $this->enableExtensions($extension_info['type'], $extension_machine_names, $extension_names);
    }
    // If there are no requirements warnings or errors, we expect to be able to
    // go through the update process uninterrupted.
    $this->drupalGet($this->statusReportUrl);
    $types = [
        'module',
        'theme',
    ];
    foreach ($types as $type) {
        $all = array_merge($core[$type], $contrib[$type]);
        $this->assertUpdateWithNoErrors($test_error_texts[$type], $type, $all);
    }
    // Delete the info.yml(s) and confirm updates are prevented.
    foreach ($file_paths as $file_path) {
        unlink($file_path);
    }
    $this->drupalGet($this->statusReportUrl);
    foreach ($types as $type) {
        $all = array_merge($core[$type], $contrib[$type]);
        $this->assertErrorOnUpdates($test_error_texts[$type], $type, $all, $test_error_urls[$type]);
    }
    // Add the info.yml file(s) back and confirm we are able to go through the
    // update process uninterrupted.
    foreach ($all_extensions_info as $machine_name => $extension_info) {
        file_put_contents($file_paths[$machine_name], Yaml::encode($extension_info));
    }
    $this->drupalGet($this->statusReportUrl);
    foreach ($types as $type) {
        $all = array_merge($core[$type], $contrib[$type]);
        $this->assertUpdateWithNoErrors($test_error_texts[$type], $type, $all);
    }
}

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