Move attribute classes from Mapping\Annotations to Mapping\Attribute namespace

Author: GromNaN

UPGRADE-2.16.md

@@ -1,5 +1,27 @@
 # UPGRADE FROM 2.15 to 2.16
 
+## Attribute namespaces
+
+Doctrine annotations are already deprecated in favor of PHP attributes. As of MongoDB ODM 2.16, the
+attribute namespaces have been changed from `Doctrine\ODM\MongoDB\Mapping\Annotations` to
+`Doctrine\ODM\MongoDB\Attributes`. The old annotation namespaces will continue to work for the time being, but
+they are deprecated and will be removed in 3.0.
+
+```diff
+- use Doctrine\ODM\MongoDB\Mapping\Annotations as ODM;
++ use Doctrine\ODM\MongoDB\Attributes as ODM;
+
+  #[ODM\Document]
+  class User
+  {
+      #[ODM\Id]
+      private string $id;
+
+      #[ODM\Field]
+      public string $name;
+  }
+```
+
 ## Lazy Proxy Directory
 
 Using proxy classes with PHP 8.4+ is deprecated, only native lazy objects will

src/Mapping/Annotations/AbstractDocument.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
+
+use function class_alias;
+
+abstract class AbstractDocument implements Annotation
+{
+}
+
+class_alias(AbstractDocument::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\AbstractDocument::class);

src/Mapping/Annotations/Annotation.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace Doctrine\ODM\MongoDB\Mapping\Annotations;
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
+
+use function class_alias;
 
 abstract class AbstractField implements Annotation
 {
@@ -41,3 +43,5 @@ public function __construct(
         $this->notSaved = $notSaved;
     }
 }
+
+class_alias(AbstractField::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\AbstractField::class);

src/Mapping/Attribute/AbstractDocument.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace Doctrine\ODM\MongoDB\Mapping\Annotations;
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
+
+use function class_alias;
 
 abstract class AbstractIndex implements Annotation
 {
@@ -57,3 +59,5 @@ public function __construct(
         $this->partialFilterExpression = $partialFilterExpression;
     }
 }
+
+class_alias(AbstractIndex::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\AbstractIndex::class);

src/Mapping/Annotations/AbstractField.php src/Mapping/Attribute/AbstractField.phpsrc/Mapping/Annotations/AbstractField.php renamed to src/Mapping/Attribute/AbstractField.php

@@ -2,11 +2,13 @@
 
 declare(strict_types=1);
 
-namespace Doctrine\ODM\MongoDB\Mapping\Annotations;
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
 
 use Attribute;
 use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
 
+use function class_alias;
+
 /**
  * Loads data from a different field if the original field is not set
  *
@@ -21,3 +23,5 @@ public function __construct(public $value, public ?string $name = null)
     {
     }
 }
+
+class_alias(AlsoLoad::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\AlsoLoad::class);

src/Mapping/Annotations/AbstractIndex.php src/Mapping/Attribute/AbstractIndex.phpsrc/Mapping/Annotations/AbstractIndex.php renamed to src/Mapping/Attribute/AbstractIndex.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
+
+use function class_alias;
+
+interface Annotation
+{
+}
+
+class_alias(Annotation::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\Annotation::class);

src/Mapping/Annotations/AlsoLoad.php src/Mapping/Attribute/AlsoLoad.phpsrc/Mapping/Annotations/AlsoLoad.php renamed to src/Mapping/Attribute/AlsoLoad.php

@@ -2,11 +2,13 @@
 
 declare(strict_types=1);
 
-namespace Doctrine\ODM\MongoDB\Mapping\Annotations;
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
 
 use Attribute;
 use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
 
+use function class_alias;
+
 /**
  * Specifies the change tracking policy for a document
  *
@@ -24,3 +26,5 @@ public function __construct(string $value)
         $this->value = $value;
     }
 }
+
+class_alias(ChangeTrackingPolicy::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\ChangeTrackingPolicy::class);

src/Mapping/Attribute/Annotation.php

@@ -2,11 +2,13 @@
 
 declare(strict_types=1);
 
-namespace Doctrine\ODM\MongoDB\Mapping\Annotations;
+namespace Doctrine\ODM\MongoDB\Mapping\Attribute;
 
 use Attribute;
 use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
 
+use function class_alias;
+
 /**
  * Specifies a default discriminator value to be used when the discriminator
  * field is not set in a document
@@ -25,3 +27,5 @@ public function __construct(string $value)
         $this->value = $value;
     }
 }
+
+class_alias(DefaultDiscriminatorValue::class, \Doctrine\ODM\MongoDB\Mapping\Annotations\DefaultDiscriminatorValue::class);