UpdatePathTestBaseTest.php in Drupal 8

Namespace

Drupal\FunctionalTests\Update

File

core/tests/Drupal/FunctionalTests/Update/UpdatePathTestBaseTest.php

<?php

namespace Drupal\FunctionalTests\Update;

use Drupal\Component\Utility\Html;
use Drupal\Component\Render\FormattableMarkup;
use Drupal\Core\Database\Database;

/**
 * Tests the update path base class.
 *
 * @group Update
 * @group legacy
 */
class UpdatePathTestBaseTest extends UpdatePathTestBase {

  /**
   * {@inheritdoc}
   */
  protected static $modules = [
    'update_test_schema',
  ];

  /**
   * {@inheritdoc}
   */
  protected function setDatabaseDumpFiles() {
    $this->databaseDumpFiles[] = __DIR__ . '/../../../../modules/system/tests/fixtures/update/drupal-8.8.0.bare.standard.php.gz';
    $this->databaseDumpFiles[] = __DIR__ . '/../../../../modules/system/tests/fixtures/update/drupal-8.update-test-schema-enabled.php';
    $this->databaseDumpFiles[] = __DIR__ . '/../../../../modules/system/tests/fixtures/update/drupal-8.update-test-semver-update-n-enabled.php';
  }

  /**
   * Tests that the database was properly loaded.
   */
  public function testDatabaseLoaded() {

    // Set a value in the cache to prove caches are cleared.
    \Drupal::service('cache.default')
      ->set(__CLASS__, 'Test');
    foreach ([
      'user' => 8100,
      'node' => 8700,
      'system' => 8805,
      'update_test_schema' => 8000,
    ] as $module => $schema) {
      $this
        ->assertEqual(drupal_get_installed_schema_version($module), $schema, new FormattableMarkup('Module @module schema is @schema', [
        '@module' => $module,
        '@schema' => $schema,
      ]));
    }

    // Ensure that all {router} entries can be unserialized. If they cannot be
    // unserialized a notice will be thrown by PHP.
    $result = \Drupal::database()
      ->query("SELECT name, route from {router}")
      ->fetchAllKeyed(0, 1);

    // For the purpose of fetching the notices and displaying more helpful error
    // messages, let's override the error handler temporarily.
    set_error_handler(function ($severity, $message, $filename, $lineno) {
      throw new \ErrorException($message, 0, $severity, $filename, $lineno);
    });
    foreach ($result as $route_name => $route) {
      try {
        unserialize($route);
      } catch (\Exception $e) {
        $this
          ->fail(sprintf('Error "%s" while unserializing route %s', $e
          ->getMessage(), Html::escape($route_name)));
      }
    }
    restore_error_handler();

    // Before accessing the site we need to run updates first or the site might
    // be broken.
    $this
      ->runUpdates();
    $this
      ->assertEquals('standard', \Drupal::config('core.extension')
      ->get('profile'));
    $this
      ->assertEqual(\Drupal::config('system.site')
      ->get('name'), 'Site-Install');
    $this
      ->drupalGet('<front>');
    $this
      ->assertText('Site-Install');

    // Ensure that the database tasks have been run during set up. Neither MySQL
    // nor SQLite make changes that are testable.
    $database = $this->container
      ->get('database');
    if ($database
      ->driver() == 'pgsql') {
      $this
        ->assertEqual('on', $database
        ->query("SHOW standard_conforming_strings")
        ->fetchField());
      $this
        ->assertEqual('escape', $database
        ->query("SHOW bytea_output")
        ->fetchField());
    }

    // Ensure the test runners cache has been cleared.
    $this
      ->assertFalse(\Drupal::service('cache.default')
      ->get(__CLASS__));
  }

  /**
   * Test that updates are properly run.
   */
  public function testUpdateHookN() {
    $connection = Database::getConnection();

    // Increment the schema version.
    \Drupal::state()
      ->set('update_test_schema_version', 8001);
    $this
      ->runUpdates();
    $select = $connection
      ->select('watchdog');
    $select
      ->orderBy('wid', 'DESC');
    $select
      ->range(0, 5);
    $select
      ->fields('watchdog', [
      'message',
    ]);
    $container_cannot_be_saved_messages = array_filter(iterator_to_array($select
      ->execute()), function ($row) {
      return strpos($row->message, 'Container cannot be saved to cache.') !== FALSE;
    });
    $this
      ->assertEqual([], $container_cannot_be_saved_messages);

    // Ensure schema has changed.
    $this
      ->assertEqual(drupal_get_installed_schema_version('update_test_schema', TRUE), 8001);
    $this
      ->assertEqual(drupal_get_installed_schema_version('update_test_semver_update_n', TRUE), 8001);

    // Ensure the index was added for column a.
    $this
      ->assertTrue($connection
      ->schema()
      ->indexExists('update_test_schema_table', 'test'), 'Version 8001 of the update_test_schema module is installed.');

    // Ensure update_test_semver_update_n_update_8001 was run.
    $this
      ->assertEquals(\Drupal::state()
      ->get('update_test_semver_update_n_update_8001'), 'Yes, I was run. Thanks for testing!');
  }

  /**
   * Tests that path aliases are not processed during database updates.
   */
  public function testPathAliasProcessing() {

    // Add a path alias for the '/admin' system path.
    $values = [
      'path' => '/admin/structure',
      'alias' => '/admin-structure-alias',
      'langcode' => 'und',
      'status' => 1,
    ];
    $database = \Drupal::database();
    $id = $database
      ->insert('path_alias')
      ->fields($values + [
      'uuid' => \Drupal::service('uuid')
        ->generate(),
    ])
      ->execute();
    $revision_id = $database
      ->insert('path_alias_revision')
      ->fields($values + [
      'id' => $id,
      'revision_default' => 1,
    ])
      ->execute();
    $database
      ->update('path_alias')
      ->fields([
      'revision_id' => $revision_id,
    ])
      ->condition('id', $id)
      ->execute();

    // Increment the schema version.
    \Drupal::state()
      ->set('update_test_schema_version', 8002);
    $this
      ->runUpdates();

    // Check that the alias defined earlier is not used during the update
    // process.
    $this
      ->assertSession()
      ->linkByHrefExists('/admin/structure');
    $this
      ->assertSession()
      ->linkByHrefNotExists('/admin-structure-alias');
    $account = $this
      ->createUser([
      'administer site configuration',
      'access administration pages',
      'access site reports',
    ]);
    $this
      ->drupalLogin($account);

    // Go to the status report page and check that the alias is used.
    $this
      ->drupalGet('admin/reports/status');
    $this
      ->assertSession()
      ->linkByHrefNotExists('/admin/structure');
    $this
      ->assertSession()
      ->linkByHrefExists('/admin-structure-alias');
  }

  /**
   * Tests that test running environment is updated when module list changes.
   *
   * @see update_test_schema_update_8003()
   */
  public function testModuleListChange() {

    // Set a value in the cache to prove caches are cleared.
    \Drupal::service('cache.default')
      ->set(__CLASS__, 'Test');

    // Ensure that modules are installed and uninstalled as expected prior to
    // running updates.
    $extension_config = $this
      ->config('core.extension')
      ->get();
    $this
      ->assertArrayHasKey('page_cache', $extension_config['module']);
    $this
      ->assertArrayNotHasKey('module_test', $extension_config['module']);
    $module_list = \Drupal::moduleHandler()
      ->getModuleList();
    $this
      ->assertArrayHasKey('page_cache', $module_list);
    $this
      ->assertArrayNotHasKey('module_test', $module_list);
    $namespaces = \Drupal::getContainer()
      ->getParameter('container.namespaces');
    $this
      ->assertArrayHasKey('Drupal\\page_cache', $namespaces);
    $this
      ->assertArrayNotHasKey('Drupal\\module_test', $namespaces);

    // Increment the schema version so that update_test_schema_update_8003()
    // runs.
    \Drupal::state()
      ->set('update_test_schema_version', 8003);
    $this
      ->runUpdates();

    // Ensure that test running environment has been updated with the changes to
    // the module list.
    $extension_config = $this
      ->config('core.extension')
      ->get();
    $this
      ->assertArrayNotHasKey('page_cache', $extension_config['module']);
    $this
      ->assertArrayHasKey('module_test', $extension_config['module']);
    $module_list = \Drupal::moduleHandler()
      ->getModuleList();
    $this
      ->assertArrayNotHasKey('page_cache', $module_list);
    $this
      ->assertArrayHasKey('module_test', $module_list);
    $namespaces = \Drupal::getContainer()
      ->getParameter('container.namespaces');
    $this
      ->assertArrayNotHasKey('Drupal\\page_cache', $namespaces);
    $this
      ->assertArrayHasKey('Drupal\\module_test', $namespaces);

    // Ensure the test runners cache has been cleared.
    $this
      ->assertFalse(\Drupal::service('cache.default')
      ->get(__CLASS__));
  }

  /**
   * Tests that schema can be excluded from testing.
   *
   * @see \Drupal\FunctionalTests\Update\UpdatePathTestBase::runUpdates()
   * @see \Drupal\Core\Test\TestSetupTrait::$configSchemaCheckerExclusions
   */
  public function testSchemaChecking() {

    // Create some configuration that should be skipped.
    $this
      ->config('config_schema_test.noschema')
      ->set('foo', 'bar')
      ->save();
    $this
      ->runUpdates();
    $this
      ->assertSame('bar', $this
      ->config('config_schema_test.noschema')
      ->get('foo'));
  }

  /**
   * Test the database fixtures are setup correctly.
   */
  public function testFixturesSetup() {
    $this
      ->assertCount(3, $this->databaseDumpFiles);
  }

}

Classes

Name	Description
UpdatePathTestBaseTest	Tests the update path base class.