Merge pull request #4805 from morozov/deprecate-can-emulate-schemas

Deprecate AbstractPlatform::canEmulateSchemas()

UPGRADE.md

@@ -8,6 +8,11 @@ awareness about deprecated code.
 
 # Upgrade to 3.2
 
+## Deprecated `AbstractPlatform::canEmulateSchemas()`.
+
+The `AbstractPlatform::canEmulateSchemas()` method and the schema emulation implemented in the SQLite platform
+have been deprecated.
+
 ## Deprecated `udf*` methods of the `SQLitePlatform` methods.
 
 The following `SQLServerPlatform` methods have been deprecated in favor of their implementations

src/Platforms/AbstractPlatform.php

@@ -3467,13 +3467,21 @@ public function supportsSchemas()
     /**
      * Whether this platform can emulate schemas.
      *
+     * @deprecated
+     *
      * Platforms that either support or emulate schemas don't automatically
      * filter a schema for the namespaced elements in {@link AbstractManager::createSchema()}.
      *
      * @return bool
      */
     public function canEmulateSchemas()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pull/4805',
+            'AbstractPlatform::canEmulateSchemas() is deprecated.'
+        );
+
         return false;
     }
 

src/Platforms/SqlitePlatform.php

@@ -800,6 +800,8 @@ public function getTemporaryTableName($tableName)
     /**
      * {@inheritDoc}
      *
+     * @deprecated
+     *
      * Sqlite Platform emulates schema by underscoring each dot and generating tables
      * into the default database.
      *
@@ -808,6 +810,12 @@ public function getTemporaryTableName($tableName)
      */
     public function canEmulateSchemas()
     {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pull/4805',
+            'SqlitePlatform::canEmulateSchemas() is deprecated.'
+        );
+
         return true;
     }