Deprecate Driver::getDatabase()

UPGRADE.md

@@ -1,5 +1,10 @@
 # Upgrade to 2.11
 
+## Deprecated `Doctrine\DBAL\Driver::getDatabase()`
+
+- The usage of `Doctrine\DBAL\Driver::getDatabase()` is deprecated. Please use `Doctrine\DBAL\Connection::getDatabase()` instead.
+- The behavior of the SQLite connection returning the database file path as the database is deprecated and shouldn't be relied upon.
+
 ## Deprecated `Portability\Connection::PORTABILITY_{PLATFORM}` constants`
 
 The platform-specific portability mode flags are meant to be used only by the portability layer internally to optimize

lib/Doctrine/DBAL/Driver.php

@@ -53,6 +53,8 @@ public function getName();
     /**
      * Gets the name of the database connected to for this driver.
      *
+     * @deprecated Use Connection::getDatabase() instead.
+     *
      * @return string The name of the database.
      */
     public function getDatabase(Connection $conn);

lib/Doctrine/DBAL/Driver/AbstractDB2Driver.php

@@ -14,6 +14,8 @@ abstract class AbstractDB2Driver implements Driver
 {
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractMySQLDriver.php

@@ -197,6 +197,8 @@ private function getMariaDbMysqlVersionNumber(string $versionString): string
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractOracleDriver.php

@@ -59,6 +59,8 @@ public function convertException($message, DriverException $exception)
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractPostgreSQLDriver.php

@@ -115,6 +115,8 @@ public function createDatabasePlatformForVersion($version)
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractSQLAnywhereDriver.php

@@ -117,6 +117,8 @@ public function createDatabasePlatformForVersion($version)
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractSQLServerDriver.php

@@ -58,6 +58,8 @@ public function createDatabasePlatformForVersion($version)
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {

lib/Doctrine/DBAL/Driver/AbstractSQLiteDriver.php

@@ -79,6 +79,8 @@ public function convertException($message, DriverException $exception)
 
     /**
      * {@inheritdoc}
+     *
+     * @deprecated Use Connection::getDatabase() instead.
      */
     public function getDatabase(Connection $conn)
     {