Merge pull request #2959 from doctrine/2.15.x

Author: IonBazan

src/Configuration.php

@@ -198,15 +198,26 @@ public function getClientEncryptionOptions(): array
 
     /**
      * Adds a namespace under a certain alias.
+     *
+     * @deprecated Document short aliases are deprecated - use ::class constant instead.
      */
     public function addDocumentNamespace(string $alias, string $namespace): void
     {
+        trigger_deprecation(
+            'doctrine/mongodb-odm',
+            '2.3',
+            'Document short namespace aliases such as "%s" are deprecated, use ::class constant instead.',
+            $alias,
+        );
+
         $this->attributes['documentNamespaces'][$alias] = $namespace;
     }
 
     /**
      * Resolves a registered namespace alias to the full namespace.
      *
+     * @deprecated Document short aliases are deprecated - use ::class constant instead.
+     *
      * @throws MongoDBException
      */
     public function getDocumentNamespace(string $documentNamespaceAlias): string
@@ -228,20 +239,36 @@ public function getDocumentNamespace(string $documentNamespaceAlias): string
     /**
      * Retrieves the list of registered document namespace aliases.
      *
+     * @deprecated Document short aliases are deprecated - use ::class constant instead.
+     *
      * @return array<string, string>
      */
     public function getDocumentNamespaces(): array
     {
+        trigger_deprecation(
+            'doctrine/mongodb-odm',
+            '2.3',
+            'Document short namespace aliases are deprecated, use ::class constant instead.',
+        );
+
         return $this->attributes['documentNamespaces'];
     }
 
     /**
      * Set the document alias map
      *
+     * @deprecated Document short aliases are deprecated - use ::class constant instead.
+     *
      * @param array<string, string> $documentNamespaces
      */
     public function setDocumentNamespaces(array $documentNamespaces): void
     {
+        trigger_deprecation(
+            'doctrine/mongodb-odm',
+            '2.3',
+            'Document short namespace aliases are deprecated, use ::class constant instead.',
+        );
+
         $this->attributes['documentNamespaces'] = $documentNamespaces;
     }