InstallTest.php

Same filename in this branch
  1. 9 core/tests/Drupal/BuildTests/TestSiteApplication/InstallTest.php
Same filename in other branches
  1. 8.9.x core/modules/system/tests/src/Functional/Module/InstallTest.php
  2. 10 core/modules/system/tests/src/Kernel/Module/InstallTest.php
  3. 10 core/tests/Drupal/BuildTests/TestSiteApplication/InstallTest.php
  4. 11.x core/modules/system/tests/src/Kernel/Module/InstallTest.php
  5. 11.x core/tests/Drupal/BuildTests/TestSiteApplication/InstallTest.php

Namespace

Drupal\Tests\system\Functional\Module

File

core/modules/system/tests/src/Functional/Module/InstallTest.php

View source
<?php

namespace Drupal\Tests\system\Functional\Module;

use Drupal\Component\Render\FormattableMarkup;
use Drupal\Core\Database\Database;
use Drupal\Core\Extension\ExtensionNameLengthException;
use Drupal\Tests\BrowserTestBase;

/**
 * Tests the installation of modules.
 *
 * @group Module
 */
class InstallTest extends BrowserTestBase {
    
    /**
     * Modules to enable.
     *
     * @var array
     */
    protected static $modules = [
        'module_test',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * Verify that module's schema can be used during module installation.
     */
    public function testGetSchemaAtInstallTime() {
        // @see module_test_install()
        $value = Database::getConnection()->select('module_test', 'mt')
            ->fields('mt', [
            'data',
        ])
            ->execute()
            ->fetchField();
        $this->assertSame('varchar', $value);
    }
    
    /**
     * Tests enabling User module once more.
     *
     * Regression: The installer might enable a module twice due to automatic
     * dependency resolution. A bug caused the stored weight for User module to
     * be an array.
     */
    public function testEnableUserTwice() {
        \Drupal::service('module_installer')->install([
            'user',
        ], FALSE);
        $this->assertSame(0, $this->config('core.extension')
            ->get('module.user'));
    }
    
    /**
     * Tests recorded schema versions of early installed modules in the installer.
     */
    public function testRequiredModuleSchemaVersions() {
        
        /** @var \Drupal\Core\Update\UpdateHookRegistry $update_registry */
        $update_registry = \Drupal::service('update.update_hook_registry');
        $version = $update_registry->getInstalledVersion('system');
        $this->assertGreaterThan(0, $version);
        $version = $update_registry->getInstalledVersion('user');
        $this->assertGreaterThan(0, $version);
        $post_update_key_value = \Drupal::keyValue('post_update');
        $existing_updates = $post_update_key_value->get('existing_updates', []);
        $this->assertContains('module_test_post_update_test', $existing_updates);
    }
    
    /**
     * Ensures that post update functions are removed on uninstall.
     */
    public function testUninstallPostUpdateFunctions() {
        \Drupal::service('module_installer')->uninstall([
            'module_test',
        ]);
        $post_update_key_value = \Drupal::keyValue('post_update');
        $existing_updates = $post_update_key_value->get('existing_updates', []);
        $this->assertNotContains('module_test_post_update_test', $existing_updates);
    }
    
    /**
     * Tests that an exception is thrown when a module name is too long.
     */
    public function testModuleNameLength() {
        $module_name = 'invalid_module_name_over_the_maximum_allowed_character_length';
        $message = new FormattableMarkup('Exception thrown when enabling module %name with a name length over the allowed maximum', [
            '%name' => $module_name,
        ]);
        try {
            $this->container
                ->get('module_installer')
                ->install([
                $module_name,
            ]);
            $this->fail($message);
        } catch (\Exception $e) {
            $this->assertInstanceOf(ExtensionNameLengthException::class, $e);
        }
        // Since for the UI, the submit callback uses FALSE, test that too.
        $message = new FormattableMarkup('Exception thrown when enabling as if via the UI the module %name with a name length over the allowed maximum', [
            '%name' => $module_name,
        ]);
        try {
            $this->container
                ->get('module_installer')
                ->install([
                $module_name,
            ], FALSE);
            $this->fail($message);
        } catch (\Exception $e) {
            $this->assertInstanceOf(ExtensionNameLengthException::class, $e);
        }
    }

}

Classes

Title Deprecated Summary
InstallTest Tests the installation of modules.

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