driver = $this->createDriver(); } public function testVersionAwarePlatformCreationIsTested(): void { if (! $this->driver instanceof VersionAwarePlatformDriver) { self::markTestSkipped('This test is only intended for version aware platform drivers.'); } self::assertNotEmpty( static::getDatabasePlatformsForVersions(), sprintf( 'No test data found for test %s. You have to return test data from %s.', static::class . '::' . __FUNCTION__, static::class . '::getDatabasePlatformsForVersions', ), ); } /** * @param class-string $expectedPlatformClass * * @dataProvider getDatabasePlatformsForVersions */ public function testCreatesDatabasePlatformForVersion( string $version, string $expectedPlatformClass, ?string $deprecation = null, ?bool $expectDeprecation = null ): void { if (! $this->driver instanceof VersionAwarePlatformDriver) { self::markTestSkipped('This test is only intended for version aware platform drivers.'); } if ($deprecation !== null) { if ($expectDeprecation ?? true) { $this->expectDeprecationWithIdentifier($deprecation); } else { $this->expectNoDeprecationWithIdentifier($deprecation); } } $actualPlatform = $this->driver->createDatabasePlatformForVersion($version); self::assertInstanceOf( $expectedPlatformClass, $actualPlatform, sprintf( 'Expected platform for version "%s" should be "%s", "%s" given', $version, $expectedPlatformClass, get_class($actualPlatform), ), ); } public function testThrowsExceptionOnCreatingDatabasePlatformsForInvalidVersion(): void { if (! $this->driver instanceof VersionAwarePlatformDriver) { self::markTestSkipped('This test is only intended for version aware platform drivers.'); } $this->expectException(Exception::class); $this->driver->createDatabasePlatformForVersion('foo'); } public function testReturnsDatabasePlatform(): void { self::assertEquals($this->createPlatform(), $this->driver->getDatabasePlatform()); } public function testReturnsSchemaManager(): void { $connection = $this->getConnectionMock(); $schemaManager = $this->driver->getSchemaManager( $connection, $this->createPlatform(), ); self::assertEquals($this->createSchemaManager($connection), $schemaManager); $re = new ReflectionProperty($schemaManager, '_conn'); $re->setAccessible(true); self::assertSame($connection, $re->getValue($schemaManager)); } public function testReturnsExceptionConverter(): void { self::assertEquals($this->createExceptionConverter(), $this->driver->getExceptionConverter()); } /** * Factory method for creating the driver instance under test. */ abstract protected function createDriver(): Driver; /** * Factory method for creating the the platform instance return by the driver under test. * * The platform instance returned by this method must be the same as returned by * the driver's getDatabasePlatform() method. * * @return P */ abstract protected function createPlatform(): AbstractPlatform; /** * Factory method for creating the the schema manager instance return by the driver under test. * * The schema manager instance returned by this method must be the same as returned by * the driver's getSchemaManager() method. * * @param Connection $connection The underlying connection to use. */ abstract protected function createSchemaManager(Connection $connection): AbstractSchemaManager; abstract protected function createExceptionConverter(): ExceptionConverter; /** @return Connection&MockObject */ protected function getConnectionMock(): Connection { return $this->createMock(Connection::class); } /** @return iterable, 2?: string, 3?: bool}> */ public function getDatabasePlatformsForVersions(): iterable { return []; } }