Allow DsnParser to parse driverClass via $schemeMapping

[kbond]

Q	A
Type	feature
Fixed issues	doctrine/DoctrineBundle#1673

Summary

The latest version of dbal & doctrine-bundle remove the ability to use a dsn (url param) to configure a custom driverClass.

This is a proposal to allow DsnParser::$schemeMapping to map an alias to a driverClass. With doctrine-bundle, these custom drivers could be added to the doctrine.dbal.driver_schemes config:

doctrine:
    dbal:
        driver_schemes:
            custom: My\Custom\Driver # implements Doctrine\DBAL\Driver

If this feature isn't desired, any other ideas?

[derrabus]

Makes perfect sense to me. Can you please also update the documentation on the DSN parser?

dbal/docs/en/reference/configuration.rst

Lines 100 to 135 in 4e673be

	Using the DSN parser
	^^^^^^^^^^^^^^^^^^^^
	By default, the URL scheme of the parsed DSN has to match one of DBAL's driver
	names. However, it might be that you have to deal with connection strings where
	you don't have control over the used scheme, e.g. in a PaaS environment. In
	order to make the parser understand which driver to use e.g. for ``mysql://``
	DSNs, you can configure the parser with a mapping table:
	.. code-block:: php
	<?php
	use Doctrine\DBAL\Tools\DsnParser;
	//..
	$dsnParser = new DsnParser(['mysql' => 'mysqli', 'postgres' => 'pdo_pgsql']);
	$connectionParams = $dsnParser
	->parse('mysql://user:secret@localhost/mydb');
	The DSN parser returns the connection params back to you so you can add or
	modify individual parameters before passing the params to the
	``DriverManager``. For example, you can add a database name if its missing in
	the DSN or hardcode one if the DSN is not allowed to configure the database
	name.
	.. code-block:: php
	<?php
	use Doctrine\DBAL\DriverManager;
	use Doctrine\DBAL\Tools\DsnParser;
	//..
	$connectionParams = $dsnParser->parse($myDsn);
	$connectionParams['dbname'] ??= 'default_db';
	$conn = DriverManager::getConnection($connectionParams);

[kbond]

Docs added.

[derrabus]

Awesome, thank you!

[MrMitch]

thank you for this feature, this is much appreciated when using a custom driver with doctrine-bundle, while still needing to use a url to configure the database connection