Deprecate AttributeDriver::$entityAnnotationClasses

Author: greg0ire

UPGRADE.md

@@ -1,5 +1,10 @@
 # Upgrade to 2.14
 
+## Deprecated `AttributeDriver::$entityAnnotationClasses`
+
+If you need to change the behavior of `AttributeDriver::isTransient()`,
+override that method instead.
+
 ## Deprecated incomplete schema updates
 
 Using `orm:schema-tool:update` without passing the `--complete` flag is

lib/Doctrine/ORM/Mapping/Driver/AttributeDriver.php

@@ -31,12 +31,18 @@ class AttributeDriver extends CompatibilityAnnotationDriver
 {
     use ColocatedMappingDriver;
 
-    /** @var array<class-string<MappingAttribute>, int> */
-    protected $entityAnnotationClasses = [
+    private const ENTITY_ATTRIBUTE_CLASSES = [
         Mapping\Entity::class => 1,
         Mapping\MappedSuperclass::class => 2,
     ];
 
+    /**
+     * @deprecated override isTransient() instead of overriding this property
+     *
+     * @var array<class-string<MappingAttribute>, int>
+     */
+    protected $entityAnnotationClasses = self::ENTITY_ATTRIBUTE_CLASSES;
+
     /**
      * The attribute reader.
      *
@@ -58,6 +64,15 @@ public function __construct(array $paths)
 
         $this->reader = new AttributeReader();
         $this->addPaths($paths);
+
+        if ($this->entityAnnotationClasses !== self::ENTITY_ATTRIBUTE_CLASSES) {
+            Deprecation::trigger(
+                'doctrine/orm',
+                'https://github.com/doctrine/orm/pull/10204',
+                'Changing the value of %s::$entityAnnotationClasses is deprecated and will have no effect in Doctrine ORM 3.0.',
+                self::class
+            );
+        }
     }
 
     /**

psalm.xml

@@ -92,6 +92,7 @@
         <DeprecatedProperty>
             <errorLevel type="suppress">
                 <referencedProperty name="Doctrine\ORM\Cache\Region\DefaultRegion::$cache"/>
+                <referencedProperty name="Doctrine\ORM\Mapping\Driver\AttributeDriver::$entityAnnotationClasses"/>
             </errorLevel>
         </DeprecatedProperty>
         <DocblockTypeContradiction>