Merge branch '2.16.x' into doctrine-cache

Author: GromNaN

UPGRADE-2.16.md

@@ -6,3 +6,11 @@ If you use `Doctrine\ODM\MongoDB\Configuration::getMetadataCacheImpl()`,
 then you need to require `doctrine/cache` explicitly in `composer.json`;
 or use `Doctrine\ODM\MongoDB\Configuration::getMetadataCache()` instead.
 
+## Lazy Proxy Directory
+
+Using proxy classes with PHP 8.4+ is deprecated, only native lazy objects will
+be supported in MongoDB ODM 3.0.
+
+Calling `Doctrine\ODM\MongoDB\Configuration::setProxyDir()` or
+`Doctrine\ODM\MongoDB\Configuration::getProxyDir()` is deprecated and triggers
+a deprecation notice when using native lazy objects.

src/Configuration.php

@@ -327,6 +327,8 @@ public function setMetadataCache(CacheItemPoolInterface $cache): void
 
     /**
      * Sets the directory where Doctrine generates any necessary proxy class files.
+     *
+     * @deprecated Since 2.16, proxy directory is no longer used when native lazy objects are enabled.
      */
     public function setProxyDir(string $dir): void
     {
@@ -336,9 +338,15 @@ public function setProxyDir(string $dir): void
 
     /**
      * Gets the directory where Doctrine generates any necessary proxy class files.
+     *
+     * @deprecated Since 2.16, proxy directory is no longer used when native lazy objects are enabled.
      */
     public function getProxyDir(): ?string
     {
+        if ($this->isNativeLazyObjectEnabled()) {
+            trigger_deprecation('doctrine/mongodb-odm', '2.16', 'Using "%s" is deprecated when native lazy objects are enabled.', __METHOD__);
+        }
+
         return $this->attributes['proxyDir'] ?? null;
     }