MigrateUpgradeFormStepsTest.php

Same filename in other branches
  1. 9 core/modules/migrate_drupal_ui/tests/src/Functional/MigrateUpgradeFormStepsTest.php
  2. 8.9.x core/modules/migrate_drupal_ui/tests/src/Functional/MigrateUpgradeFormStepsTest.php
  3. 11.x core/modules/migrate_drupal_ui/tests/src/Functional/MigrateUpgradeFormStepsTest.php

Namespace

Drupal\Tests\migrate_drupal_ui\Functional

File

core/modules/migrate_drupal_ui/tests/src/Functional/MigrateUpgradeFormStepsTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\migrate_drupal_ui\Functional;

use Drupal\migrate_drupal\MigrationConfigurationTrait;
use Drupal\Tests\migrate_drupal\Traits\CreateTestContentEntitiesTrait;
use Drupal\Tests\BrowserTestBase;
use Drupal\Tests\WebAssert;

/**
 * Tests the flow of the Migrate Drupal UI form.
 *
 * @group migrate_drupal_ui
 */
class MigrateUpgradeFormStepsTest extends BrowserTestBase {
    use MigrationConfigurationTrait;
    use CreateTestContentEntitiesTrait;
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        'migrate_drupal_ui',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        // Log in as user 1. Migrations in the UI can only be performed as user 1.
        $this->drupalLogin($this->rootUser);
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getSourceBasePath() {
        return __DIR__ . '/files';
    }
    
    /**
     * Tests the flow of the Migrate Drupal UI form.
     *
     * The Migrate Drupal UI uses several forms to guide you through the upgrade
     * process. The forms displayed depend on if this is an incremental migration
     * or if there are potential ID conflicts. The forms are to be displayed in
     * this order; Overview or Incremental, if a migration has already been run
     * then Credential, Id conflict, if conflicts are detected, and lastly Review.
     */
    public function testMigrateUpgradeReviewPage() : void {
        
        /** @var \Drupal\Core\TempStore\PrivateTempStore  $store */
        $store = \Drupal::service('tempstore.private')->get('migrate_drupal_ui');
        $state = \Drupal::service('state');
        // Test that when data required by a form is missing that the correct first
        // form is displayed. The first form for an initial migration is the
        // Overview form and for an incremental migration it is the Incremental
        // form.
        $session = $this->assertSession();
        // Get the current major version.
        [
            $destination_site_version,
        ] = explode('.', \Drupal::VERSION, 2);
        $expected['initial'] = "Upgrade a site by importing its files and the data from its database into a clean and empty new install of Drupal {$destination_site_version}.";
        $expected['incremental'] = "An upgrade has already been performed on this site.";
        foreach ([
            '/upgrade',
            '/upgrade/incremental',
        ] as $expected) {
            if ($expected === '/upgrade/incremental') {
                // Set a performed time to signify an incremental migration. The time
                // value is a UNIX timestamp.
                $state->set('migrate_drupal_ui.performed', 1);
            }
            // Test that an invalid step to any form goes to the correct first form.
            $store->set('step', 'foo');
            $this->assertFirstForm($session, $expected);
            // Test that an undefined step to any form goes to the correct first form.
            $store->delete('step');
            $this->assertFirstForm($session, $expected);
            // For forms that require data from the private store, test that when that
            // data is missing the correct first page is displayed.
            // The Id conflict form requires the migrations array.
            $store->delete('migrations');
            $store->set('step', 'idconflict');
            $this->drupalGet('/upgrade/idconflict');
            $session->addressEquals($expected);
            // The Review form requires version, migrations and system_data. Test
            // three times with only one of the variables missing.
            $store->delete('version');
            $store->set('migrations', [
                'foo',
                'bar',
            ]);
            $store->set('system_data', [
                'bar',
                'foo',
            ]);
            $store->set('step', 'review');
            $this->drupalGet('/upgrade/review');
            $session->addressEquals($expected);
            $store->set('version', '6');
            $store->delete('migrations');
            $store->set('system_data', [
                'bar',
                'foo',
            ]);
            $store->set('step', 'review');
            $this->drupalGet('/upgrade/review');
            $session->addressEquals($expected);
            $store->set('version', '6');
            $store->set('migrations', [
                'foo',
                'bar',
            ]);
            $store->delete('system_data');
            $store->set('step', 'review');
            $this->drupalGet('/upgrade/review');
            $session->addressEquals($expected);
        }
        // Test that the credential form is displayed for incremental migrations.
        $store->set('step', 'overview');
        $this->drupalGet('/upgrade');
        $session->pageTextContains("An upgrade has already been performed on this site. To perform a new migration, create a clean and empty new install of Drupal {$destination_site_version}. Rollbacks are not yet supported through the user interface.");
        $this->submitForm([], 'Import new configuration and content from old site');
        $session->pageTextContains('Provide credentials for the database of the Drupal site you want to upgrade.');
    }
    
    /**
     * Helper to test that a path goes to the Overview form.
     *
     * @param \Drupal\Tests\WebAssert $session
     *   The WebAssert object.
     * @param string $expected
     *   The expected response text.
     *
     * @internal
     */
    protected function assertFirstForm(WebAssert $session, string $expected) : void {
        $paths = [
            '',
            '/incremental',
            '/credentials',
            '/idconflict',
            '/review',
        ];
        foreach ($paths as $path) {
            $this->drupalGet('/upgrade' . $path);
            $session->addressEquals($expected);
        }
    }

}

Classes

Title Deprecated Summary
MigrateUpgradeFormStepsTest Tests the flow of the Migrate Drupal UI form.

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