Replace comment with real method signature

UPGRADE.md

@@ -8,6 +8,11 @@ awareness about deprecated code.
 
 # Upgrade to 4.0
 
+## BC Break: Added `ObjectManager::isUninitializedObject()`
+
+Classes implementing `Doctrine\Persistence\ObjectManager` must implement this
+new method.
+
 ## BC Break: Dropped support for Common proxies
 
 Proxy objects implementing the `Doctrine\Common\Proxy\Proxy` interface are not

src/Persistence/ObjectManager.php

@@ -7,11 +7,7 @@
 use Doctrine\Persistence\Mapping\ClassMetadata;
 use Doctrine\Persistence\Mapping\ClassMetadataFactory;
 
-/**
- * Contract for a Doctrine persistence layer ObjectManager class to implement.
- *
- * @method bool isUninitializedObject(mixed $value) Implementing this method will be mandatory in version 4.
- */
+/** Contract for a Doctrine persistence layer ObjectManager class to implement. */
 interface ObjectManager
 {
     /**
@@ -136,6 +132,9 @@ public function getMetadataFactory();
      */
     public function initializeObject(object $obj);
 
+    /** Helper method to check whether a lazy loading proxy or persistent collection has been initialized. */
+    public function isUninitializedObject(mixed $value): bool;
+
     /**
      * Checks if the object is part of the current UnitOfWork and therefore managed.
      *

src/Persistence/ObjectManagerDecorator.php

@@ -82,6 +82,11 @@ public function initializeObject(object $obj)
         $this->wrapped->initializeObject($obj);
     }
 
+    public function isUninitializedObject(mixed $value): bool
+    {
+        return $this->wrapped->isUninitializedObject($value);
+    }
+
     /**
      * {@inheritDoc}
      */

tests/Persistence/ObjectManagerDecoratorTest.php

@@ -155,6 +155,19 @@ public function testContains(): void
 
         self::assertTrue($this->decorated->contains($object));
     }
+
+    /** @requires PHP 8.0 */
+    public function testIsUninitializedObject(): void
+    {
+        $object = new TestObject();
+
+        $this->wrapped->expects(self::once())
+            ->method('isUninitializedObject')
+            ->with($object)
+            ->willReturn(false);
+
+        self::assertFalse($this->decorated->isUninitializedObject($object));
+    }
 }
 
 /** @extends ObjectManagerDecorator<ObjectManager&MockObject> */