Merge branch '3.10.x' into 4.3.x

* 3.10.x:
  Document the PDO subclasses backport (#7137)
  Downgrade PHP for the DB2 workflow (#7134)
  Workaround for MySQL 8.4 and unknown users (#7136)
  Leverage PHP 8.4 PDO classes, fix PHP 8.5 deprecation (#7132)
  Run tests on MySQL 8.4 LTS and 9.4 (#7133)

Author: derrabus

.github/workflows/continuous-integration.yml

@@ -189,21 +189,22 @@ jobs:
         mysql-version:
           - "5.7"
           - "8.0" # We have code specific to ^8.0
-          - "9.3"
+          - "8.4" # LTS
+          - "9.4"
         extension:
           - "mysqli"
           - "pdo_mysql"
         include:
           - config-file-suffix: "-tls"
             php-version: "8.2"
-            mysql-version: "9.1"
+            mysql-version: "9.4"
             extension: "mysqli"
           - config-file-suffix: "-stringify_fetches"
             php-version: "8.2"
-            mysql-version: "9.1"
+            mysql-version: "9.4"
             extension: "pdo_mysql"
           - php-version: "8.2"
-            mysql-version: "9.1"
+            mysql-version: "9.4"
             extension: "mysqli"
 
   phpunit-mssql:
@@ -246,7 +247,8 @@ jobs:
         php-version:
           - "8.2"
           - "8.3"
-          - "8.4"
+          # The DB2 workflow currently segfaults with PHP 8.4
+          # - "8.4"
 
   development-deps:
     name: "PHPUnit with PDO_SQLite and development dependencies"

UPGRADE.md

@@ -1354,6 +1354,16 @@ The following methods have been removed.
 
 # Upgrade to 3.10
 
+## Support for new PDO subclasses on PHP 8.4
+
+In 3.10.2, we've backported support for new PDO subclasses introduced in PHP 8.4 because not using them
+could trigger deprecation warnings under certain circumstances in PHP 8.5.
+
+On PHP 8.4, if you call `getNativeConnection()` on a connection established through one of the PDO drivers,
+you will get an instance of the new PDO subclasses, e.g. `Pdo\Mysql` or `Pdo\Pgsql` instead of just `PDO`.
+
+## Optional `doctrine/cache` dependency
+
 The `doctrine/cache` package is now an optional dependency. If you are using the
 `Doctrine\DBAL\Cache` classes, you need to require the `doctrine/cache` package
 explicitly.

src/Driver/API/MySQL/ExceptionConverter.php

@@ -22,6 +22,8 @@
 use Doctrine\DBAL\Exception\UniqueConstraintViolationException;
 use Doctrine\DBAL\Query;
 
+use function str_contains;
+
 /** @internal */
 final class ExceptionConverter implements ExceptionConverterInterface
 {
@@ -31,6 +33,15 @@ final class ExceptionConverter implements ExceptionConverterInterface
      */
     public function convert(Exception $exception, ?Query $query): DriverException
     {
+        if (
+            $exception->getCode() === 1524
+            && str_contains($exception->getMessage(), 'Plugin \'mysql_native_password\' is not loaded')
+        ) {
+            // Workaround for MySQL 8.4 if we request an unknown user.
+            // https://bugs.mysql.com/bug.php?id=114876
+            return new ConnectionException($exception, $query);
+        }
+
         return match ($exception->getCode()) {
             1008 => new DatabaseDoesNotExist($exception, $query),
             1213 => new DeadlockException($exception, $query),

src/Driver/PDO/PgSQL/Driver.php

@@ -10,11 +10,14 @@
 use Doctrine\DBAL\Driver\PDO\Exception\InvalidConfiguration;
 use Doctrine\DBAL\Driver\PDO\PDOConnect;
 use PDO;
+use Pdo\Pgsql;
 use PDOException;
 use SensitiveParameter;
 
 use function is_string;
 
+use const PHP_VERSION_ID;
+
 final class Driver extends AbstractPostgreSQLDriver
 {
     use PDOConnect;
@@ -52,11 +55,11 @@ public function connect(
             throw Exception::new($exception);
         }
 
-        if (
-            ! isset($driverOptions[PDO::PGSQL_ATTR_DISABLE_PREPARES])
-            || $driverOptions[PDO::PGSQL_ATTR_DISABLE_PREPARES] === true
-        ) {
-            $pdo->setAttribute(PDO::PGSQL_ATTR_DISABLE_PREPARES, true);
+        $disablePreparesAttr = PHP_VERSION_ID >= 80400
+            ? Pgsql::ATTR_DISABLE_PREPARES
+            : PDO::PGSQL_ATTR_DISABLE_PREPARES;
+        if ($driverOptions[$disablePreparesAttr] ?? true) {
+            $pdo->setAttribute($disablePreparesAttr, true);
         }
 
         $connection = new Connection($pdo);