class DatabaseTest

Same name in other branches
  1. 8.9.x core/tests/Drupal/Tests/Core/Database/DatabaseTest.php \Drupal\Tests\Core\Database\DatabaseTest
  2. 10 core/tests/Drupal/Tests/Core/Database/DatabaseTest.php \Drupal\Tests\Core\Database\DatabaseTest

@coversDefaultClass \Drupal\Core\Database\Database

@runTestsInSeparateProcesses @preserveGlobalState disabled

@group Database

Hierarchy

Expanded class hierarchy of DatabaseTest

File

core/tests/Drupal/Tests/Core/Database/DatabaseTest.php, line 18

Namespace

Drupal\Tests\Core\Database
View source
class DatabaseTest extends UnitTestCase {
    
    /**
     * A classloader to enable testing of contrib drivers.
     *
     * @var \Composer\Autoload\ClassLoader
     */
    protected $additionalClassloader;
    
    /**
     * Path to DRUPAL_ROOT.
     *
     * @var string
     */
    protected $root;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        $this->additionalClassloader = new ClassLoader();
        $this->additionalClassloader
            ->register();
        // Mock the container so we don't need to mock drupal_valid_test_ua().
        // @see \Drupal\Core\Extension\ExtensionDiscovery::scan()
        $this->root = dirname(__DIR__, 6);
        $container = $this->createMock(ContainerInterface::class);
        $container->expects($this->any())
            ->method('has')
            ->with('kernel')
            ->willReturn(TRUE);
        $container->expects($this->any())
            ->method('getParameter')
            ->with('site.path')
            ->willReturn('');
        \Drupal::setContainer($container);
    }
    
    /**
     * @covers ::findDriverAutoloadDirectory
     * @dataProvider providerFindDriverAutoloadDirectory
     */
    public function testFindDriverAutoloadDirectory($expected, $namespace, $include_test_drivers) {
        $this->assertSame($expected, Database::findDriverAutoloadDirectory($namespace, $this->root, $include_test_drivers));
    }
    
    /**
     * Data provider for ::testFindDriverAutoloadDirectory().
     *
     * @return array
     */
    public function providerFindDriverAutoloadDirectory() {
        return [
            'core mysql' => [
                'core/modules/mysql/src/Driver/Database/mysql/',
                'Drupal\\mysql\\Driver\\Database\\mysql',
                FALSE,
            ],
            'D8 custom fake' => [
                FALSE,
                'Drupal\\Driver\\Database\\corefake',
                TRUE,
            ],
            'module mysql' => [
                'core/modules/system/tests/modules/driver_test/src/Driver/Database/DrivertestMysql/',
                'Drupal\\driver_test\\Driver\\Database\\DrivertestMysql',
                TRUE,
            ],
        ];
    }
    
    /**
     * @covers ::findDriverAutoloadDirectory
     * @dataProvider providerFindDriverAutoloadDirectoryException
     */
    public function testFindDriverAutoloadDirectoryException($expected_message, $namespace, $include_tests) {
        $this->expectException(\RuntimeException::class);
        $this->expectExceptionMessage($expected_message);
        Database::findDriverAutoloadDirectory($namespace, $this->root, $include_tests);
    }
    
    /**
     * Data provider for ::testFindDriverAutoloadDirectoryException().
     *
     * @return array
     */
    public function providerFindDriverAutoloadDirectoryException() {
        return [
            'test module but tests not included' => [
                "Cannot find the module 'driver_test' for the database driver namespace 'Drupal\\driver_test\\Driver\\Database\\DrivertestMysql'",
                'Drupal\\driver_test\\Driver\\Database\\DrivertestMysql',
                FALSE,
            ],
            'non-existent driver in test module' => [
                "Cannot find the database driver namespace 'Drupal\\driver_test\\Driver\\Database\\sqlite' in module 'driver_test'",
                'Drupal\\driver_test\\Driver\\Database\\sqlite',
                TRUE,
            ],
            'non-existent module' => [
                "Cannot find the module 'does_not_exist' for the database driver namespace 'Drupal\\does_not_exist\\Driver\\Database\\mysql'",
                'Drupal\\does_not_exist\\Driver\\Database\\mysql',
                TRUE,
            ],
        ];
    }
    
    /**
     * Adds a database driver that uses the D8's Drupal\Driver\Database namespace.
     */
    protected function addD8CustomDrivers() {
        $this->additionalClassloader
            ->addPsr4("Drupal\\Driver\\Database\\corefake\\", __DIR__ . "/../../../../../tests/fixtures/database_drivers/custom/corefake");
    }
    
    /**
     * Adds database drivers that are provided by modules.
     */
    protected function addModuleDrivers() {
        $this->additionalClassloader
            ->addPsr4("Drupal\\driver_test\\Driver\\Database\\DrivertestMysql\\", __DIR__ . "/../../../../../modules/system/tests/modules/driver_test/src/Driver/Database/DrivertestMysql");
        $this->additionalClassloader
            ->addPsr4("Drupal\\corefake\\Driver\\Database\\corefake\\", __DIR__ . "/../../../../../tests/fixtures/database_drivers/module/corefake/src/Driver/Database/corefake");
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title
DatabaseTest::$additionalClassloader protected property A classloader to enable testing of contrib drivers.
DatabaseTest::$root protected property Path to DRUPAL_ROOT. Overrides UnitTestCase::$root
DatabaseTest::addD8CustomDrivers protected function Adds a database driver that uses the D8's Drupal\Driver\Database namespace.
DatabaseTest::addModuleDrivers protected function Adds database drivers that are provided by modules.
DatabaseTest::providerFindDriverAutoloadDirectory public function Data provider for ::testFindDriverAutoloadDirectory().
DatabaseTest::providerFindDriverAutoloadDirectoryException public function Data provider for ::testFindDriverAutoloadDirectoryException().
DatabaseTest::setUp protected function Overrides UnitTestCase::setUp
DatabaseTest::testFindDriverAutoloadDirectory public function @covers ::findDriverAutoloadDirectory
@dataProvider providerFindDriverAutoloadDirectory
DatabaseTest::testFindDriverAutoloadDirectoryException public function @covers ::findDriverAutoloadDirectory
@dataProvider providerFindDriverAutoloadDirectoryException
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::assertArrayEquals Deprecated protected function Asserts if two arrays are equal by sorting them first.
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator protected function Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName public function Generates a unique random string containing letters and numbers.
UnitTestCase::setUpBeforeClass public static function

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