PreventDowngradeTest.php

<?php

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

use Drupal\FunctionalTests\Update\UpdatePathTestBase;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;

/**
 * Tests that a site on 11.4.0 is prevented from downgrading to 12.0.0.
 *
 * This tests the upgrade path when there is a pair of equivalent updates. The
 * earlier update is 11102 and the latter one is 12001.
 */
class PreventDowngradeTest extends UpdatePathTestBase {
  
  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';
  
  /**
   * {@inheritdoc}
   */
  protected function setDatabaseDumpFiles() : void {
    $this->databaseDumpFiles[] = __DIR__ . '/../../../../tests/fixtures/update/drupal-11.3.0.filled.standard.php.gz';
  }
  
  /**
   * Tests prevention of incorrect update path.
   */
  public function testDowngradePrevention() : void {
    $database = \Drupal::database();
    // Record the update 12001 as an equivalent to update 11102.
    $database->insert('key_value')
      ->fields([
      'collection' => 'core.equivalent_updates',
      'name' => 'downgrade_prevention_test',
      'value' => 'a:1:{i:12001;a:2:{s:10:"ran_update";s:5:"11102";s:21:"future_version_string";s:6:"11.4.0";}}',
    ])
      ->execute();
    // Set the test module schema to 12001.
    $database->insert('key_value')
      ->fields([
      'value' => 'i:12001;',
      'collection' => 'system.schema',
      'name' => 'downgrade_prevention_test',
    ])
      ->execute();
    // Running the updates should fail with a requirements failure because the
    // later update, 12001, is missing from the code base.
    try {
      $this->runUpdates();
    } catch (\Exception) {
      // Continue.
    }
    $this->assertSession()
      ->pageTextContains('Missing updates for: 11.4 downgrade prevention test');
    $this->assertSession()
      ->pageTextContains('The version of the 11.4 downgrade prevention test module that you are attempting to update to is missing update 12001 (which was marked as an equivalent by 11102). Update to at least Drupal Core 11.4.0.');
    // Repeat the test with a code base that does have the 12001 update,
    // downgrade_prevention_test_update_12001(). First, install
    // downgrade_prevention_test.
    $extensions = $database->select('config')
      ->fields('config', [
      'data',
    ])
      ->condition('collection', '')
      ->condition('name', 'core.extension')
      ->execute()
      ->fetchField();
    $extensions = unserialize($extensions);
    // Install the 'downgrade_prevention_test' module.
    $extensions['module']['downgrade_prevention_test'] = 0;
    $database->update('config')
      ->fields([
      'data' => serialize($extensions),
    ])
      ->condition('collection', '')
      ->condition('name', 'core.extension')
      ->execute();
    // Set the schema for 'downgrade_prevention_test' to the update function,
    // 12001.
    $database->update('key_value')
      ->fields([
      'value' => 'i:12001;',
    ])
      ->condition('collection', 'system.schema')
      ->condition('name', 'downgrade_prevention_test')
      ->execute();
    // Running the updates should succeed because the 12001 update function,
    // downgrade_prevention_test_update_12001(), now exists.
    $this->runUpdates();
    $this->assertSession()
      ->pageTextContains('Updates were attempted.');
  }

}