UpdatePathTestBaseTest.php

Same filename in other branches
  1. 8.9.x core/tests/Drupal/FunctionalTests/Update/UpdatePathTestBaseTest.php
  2. 10 core/tests/Drupal/FunctionalTests/Update/UpdatePathTestBaseTest.php
  3. 11.x core/tests/Drupal/FunctionalTests/Update/UpdatePathTestBaseTest.php

Namespace

Drupal\FunctionalTests\Update

File

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

View source
<?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
 */
class UpdatePathTestBaseTest extends UpdatePathTestBase {
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        'update_test_schema',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected function setDatabaseDumpFiles() {
        $this->databaseDumpFiles[] = __DIR__ . '/../../../../modules/system/tests/fixtures/update/drupal-9.0.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');
        
        /** @var \Drupal\Core\Update\UpdateHookRegistry $update_registry */
        $update_registry = \Drupal::service('update.update_hook_registry');
        foreach ([
            'user' => 8100,
            'node' => 8700,
            'system' => 8901,
            'update_test_schema' => 8000,
        ] as $module => $schema) {
            $this->assertEquals($schema, $update_registry->getInstalledVersion($module), 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()->select('router', 'r')
            ->fields('r', [
            'name',
            'route',
        ])
            ->execute()
            ->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->assertEquals('Site-Install', \Drupal::config('system.site')->get('name'));
        $this->drupalGet('<front>');
        $this->assertSession()
            ->pageTextContains('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->assertEquals('on', $database->query("SHOW standard_conforming_strings")
                ->fetchField());
            $this->assertEquals('escape', $database->query("SHOW bytea_output")
                ->fetchField());
        }
        // Ensure the test runners cache has been cleared.
        $this->assertFalse(\Drupal::service('cache.default')->get(__CLASS__));
    }
    
    /**
     * Tests 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();
        // Ensure that after running the updates the update functions have been
        // loaded. If they have not then the tests carried out in
        // \Drupal\Tests\UpdatePathTestTrait::runUpdates() can result in false
        // positives.
        $this->assertTrue(function_exists('update_test_semver_update_n_update_8001'), 'The update_test_semver_update_n_update_8001() has been loaded');
        $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->assertEquals([], $container_cannot_be_saved_messages);
        // Ensure schema has changed.
        
        /** @var \Drupal\Core\Update\UpdateHookRegistry $update_registry */
        $update_registry = \Drupal::service('update.update_hook_registry');
        $this->assertEquals(8001, $update_registry->getInstalledVersion('update_test_schema'));
        $this->assertEquals(8001, $update_registry->getInstalledVersion('update_test_semver_update_n'));
        // 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('Yes, I was run. Thanks for testing!', \Drupal::state()->get('update_test_semver_update_n_update_8001'));
    }
    
    /**
     * 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'));
    }
    
    /**
     * Tests the database fixtures are setup correctly.
     */
    public function testFixturesSetup() {
        $this->assertCount(3, $this->databaseDumpFiles);
    }

}

Classes

Title Deprecated Summary
UpdatePathTestBaseTest Tests the update path base class.

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