Deprecate AbstractPlatform::prefersIdentityColumns()

UPGRADE.md

@@ -220,6 +220,11 @@ Relying on the name of the platform is discouraged. To identify the platform, us
 The `ServerInfoAwareConnection` and `VersionAwarePlatformDriver` interfaces are deprecated. In the next major version,
 all drivers and driver connections will be required to implement the APIs aware of the server version.
 
+## Deprecated `AbstractPlatform::prefersIdentityColumns()`.
+
+Whether to use identity columns should be decided by the application developer. For example, based on the set
+of supported database platforms.
+
 ## Deprecated `AbstractPlatform::getNowExpression()`.
 
 Relying on dates generated by the database is deprecated. Generate dates within the application.

psalm.xml.dist

@@ -210,6 +210,15 @@
                     See https://github.com/doctrine/dbal/pull/4966
                 -->
                 <referencedMethod name="Doctrine\DBAL\Connection::getWrappedConnection"/>
+                <!--
+                    TODO: remove in 4.0.0
+                    See https://github.com/doctrine/dbal/pull/1519
+                -->
+                <referencedMethod name="Doctrine\DBAL\Platforms\AbstractMySQLPlatform::prefersIdentityColumns"/>
+                <referencedMethod name="Doctrine\DBAL\Platforms\AbstractPlatform::prefersIdentityColumns"/>
+                <referencedMethod name="Doctrine\DBAL\Platforms\DB2Platform::prefersIdentityColumns"/>
+                <referencedMethod name="Doctrine\DBAL\Platforms\SQLServerPlatform::prefersIdentityColumns"/>
+                <referencedMethod name="Doctrine\DBAL\Platforms\SqlitePlatform::prefersIdentityColumns"/>
             </errorLevel>
         </DeprecatedMethod>
         <DeprecatedProperty>

src/Platforms/AbstractMySQLPlatform.php

@@ -279,11 +279,19 @@ public function getBooleanTypeDeclarationSQL(array $column)
     /**
      * {@inheritDoc}
      *
+     * @deprecated
+     *
      * MySQL prefers "autoincrement" identity columns since sequences can only
      * be emulated with a table.
      */
     public function prefersIdentityColumns()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pulls/1519',
+            'AbstractMySQLPlatform::prefersIdentityColumns() is deprecated.'
+        );
+
         return true;
     }
 

src/Platforms/AbstractPlatform.php

@@ -2914,10 +2914,18 @@ public function getColumnCollationDeclarationSQL($collation)
      * Whether the platform prefers identity columns (eg. autoincrement) for ID generation.
      * Subclasses should override this method to return TRUE if they prefer identity columns.
      *
+     * @deprecated
+     *
      * @return bool
      */
     public function prefersIdentityColumns()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pulls/1519',
+            'AbstractPlatform::prefersIdentityColumns() is deprecated.'
+        );
+
         return false;
     }
 

src/Platforms/DB2Platform.php

@@ -847,9 +847,17 @@ public function supportsIdentityColumns()
 
     /**
      * {@inheritDoc}
+     *
+     * @deprecated
      */
     public function prefersIdentityColumns()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pulls/1519',
+            'DB2Platform::prefersIdentityColumns() is deprecated.'
+        );
+
         return true;
     }
 

src/Platforms/SQLServerPlatform.php

@@ -98,9 +98,17 @@ public function getDateDiffExpression($date1, $date2)
      *
      * Microsoft SQL Server prefers "autoincrement" identity columns
      * since sequences can only be emulated with a table.
+     *
+     * @deprecated
      */
     public function prefersIdentityColumns()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pulls/1519',
+            'SQLServerPlatform::prefersIdentityColumns() is deprecated.'
+        );
+
         return true;
     }
 

src/Platforms/SqlitePlatform.php

@@ -205,9 +205,17 @@ public function getSetTransactionIsolationSQL($level)
 
     /**
      * {@inheritDoc}
+     *
+     * @deprecated
      */
     public function prefersIdentityColumns()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pulls/1519',
+            'SqlitePlatform::prefersIdentityColumns() is deprecated.'
+        );
+
         return true;
     }
 

tests/Functional/WriteTest.php

@@ -149,7 +149,7 @@ public function testUpdate(): void
 
     public function testLastInsertId(): void
     {
-        if (! $this->connection->getDatabasePlatform()->prefersIdentityColumns()) {
+        if (! $this->connection->getDatabasePlatform()->supportsIdentityColumns()) {
             self::markTestSkipped('Test only works on platforms with identity columns.');
         }