Standalone DSN parser

[derrabus]

Q	A
Type	feature
Fixed issues	#5814, symfony/recipes#1139 (comment)

Summary

See the linked issue for details and motivation.

This PR extracts the parsing of the url config param into a dedicated class. This allows to configure how we map URL schemes to DBAL drivers before we parse a database URL. The idea is that DriverManager becomes unaware of database URLs entirely, giving the app full control over:

• which drivers should be used for which database engine,
• which connection parameters a URL is allowed to provide, and
• how connection parameters are merged with other configuration sources.

This also obsoletes the deprecation introduced by #5697: Once DriverManager does not parse database URLs anymore, the mapping from schemes to drivers becomes a userland concern or a concern of the integration layer (e.g. DoctrineBundle).

[faizanakram99]

@derrabus

How to pass driver options now ?

Earlier it used to be

$connection = DriverManager::getConnection([
    'url' => $this->databaseUrl,
    'driverOptions' => $driverOptions,
    'defaultTableOptions' => [
        'charset' => 'utf8mb4',
        'collate' => 'utf8mb4_0900_ai_ci',
    ],
]);

Now it is

$dsnParser  = new DsnParser(['mysql' => 'pdo_mysql']);
$connection = DriverManager::getConnection(
    $dsnParser->parse('mysql://my-user:t0ps3cr3t@my-host/my-database'),
   // how to pass driverOptions, defaultTableOptions etc ?
);

[derrabus]

Merge them into the array that the parser returns before passing it to the driver manager.

[faizanakram99]

Merge them into the array that the parser returns before passing it to the driver manager.

Oh my bad, parser returns array 😂 ... didn't notice it