Deprecate methods related to the annotation driver

Author: greg0ire

UPGRADE.md

@@ -5,6 +5,10 @@
 Please switch to one of the other mapping drivers. Native attributes which PHP
 supports since version 8.0 are probably your best option.
 
+As a consequence, the following methods are deprecated:
+- `ORMSetup::createAnnotationMetadataConfiguration`
+- `ORMSetup::createDefaultAnnotationDriver`
+
 ## Deprecated `Doctrine\ORM\Proxy\Proxy` interface.
 
 Use `Doctrine\Persistence\Proxy` instead to check whether proxies are initialized.

lib/Doctrine/ORM/ORMSetup.php

@@ -31,6 +31,8 @@ final class ORMSetup
     /**
      * Creates a configuration with an annotation metadata driver.
      *
+     * @deprecated Use another mapping driver.
+     *
      * @param string[] $paths
      */
     public static function createAnnotationMetadataConfiguration(
@@ -39,6 +41,12 @@ public static function createAnnotationMetadataConfiguration(
         ?string $proxyDir = null,
         ?CacheItemPoolInterface $cache = null
     ): Configuration {
+        Deprecation::trigger(
+            'doctrine/orm',
+            'https://github.com/doctrine/orm/issues/10098',
+            '%s is deprecated and will be removed in Doctrine ORM 3.0',
+            __METHOD__
+        );
         $config = self::createConfiguration($isDevMode, $proxyDir, $cache);
         $config->setMetadataDriverImpl(self::createDefaultAnnotationDriver($paths));
 
@@ -48,12 +56,20 @@ public static function createAnnotationMetadataConfiguration(
     /**
      * Adds a new default annotation driver with a correctly configured annotation reader.
      *
+     * @deprecated Use another mapping driver.
+     *
      * @param string[] $paths
      */
     public static function createDefaultAnnotationDriver(
         array $paths = [],
         ?CacheItemPoolInterface $cache = null
     ): AnnotationDriver {
+        Deprecation::trigger(
+            'doctrine/orm',
+            'https://github.com/doctrine/orm/issues/10098',
+            '%s is deprecated and will be removed in Doctrine ORM 3.0',
+            __METHOD__
+        );
         if (! class_exists(AnnotationReader::class)) {
             throw new LogicException(sprintf(
                 'The annotation metadata driver cannot be enabled because the "doctrine/annotations" library'

psalm.xml

@@ -76,6 +76,7 @@
                 <referencedMethod name="Doctrine\ORM\Configuration::newDefaultAnnotationDriver"/>
                 <referencedMethod name="Doctrine\ORM\Id\AbstractIdGenerator::generate"/>
                 <referencedMethod name="Doctrine\ORM\ORMInvalidArgumentException::invalidEntityName"/>
+                <referencedMethod name="Doctrine\ORM\ORMSetup::createDefaultAnnotationDriver"/>
                 <referencedMethod name="Doctrine\ORM\Query\TreeWalkerAdapter::_getQueryComponents"/>
                 <file name="lib/Doctrine/ORM/Query/TreeWalkerChain.php"/>
             </errorLevel>