Deprecate Connection::getWrappedConnection(), mark Connection::connec…

…t() internal

UPGRADE.md

@@ -8,6 +8,13 @@ awareness about deprecated code.
 
 # Upgrade to 3.2
 
+## Deprecated `Connection::getWrappedConnection()`, `Connection::connect()` made `@internal`.
+
+The wrapper-level `Connection::getWrappedConnection()` method has been deprecated. Use a custom driver implementation
+to access the underlying connection.
+
+The `Connection::connect()` method has been marked internal. It will be marked `protected` in DBAL 4.0.
+
 ## Deprecated `AbstractSchemaManager::dropAndCreate*()` and `::tryMethod()` methods.
 
 The following `AbstractSchemaManager::dropAndCreate*()` methods have been deprecated:

src/Connection.php

@@ -312,6 +312,8 @@ public function getExpressionBuilder()
     /**
      * Establishes the connection with the database.
      *
+     * @internal This method will be made protected in DBAL 4.0.
+     *
      * @return bool TRUE if the connection was successfully established, FALSE if
      *              the connection is already open.
      *
@@ -1496,6 +1498,8 @@ public function rollbackSavepoint($savepoint)
     /**
      * Gets the wrapped driver connection.
      *
+     * @deprecated Use a custom {@link Driver} implementation to access the underlying connection.
+     *
      * @return DriverConnection
      *
      * @throws Exception