Add support for PHP 8.4 Lazy Objects with configuration flag

[GromNaN]

Q	A
Type	feature
BC Break	no
Fixed issues	PHPORM-321 Fix #2828

Summary

Shamelessly copied from the brilliant work of Benjamin Eberlei on ORM:

• PropertyAccessor: Necessary refactorings for Property hooks orm#11659
• Native Lazy Objects: Add support for PHP 8.4 Lazy Objects RFC with configuration flag orm#11853

[Copilot]

Pull Request Overview

This PR adds support for PHP 8.4 Lazy Objects with a configuration flag, implementing native lazy loading functionality as an alternative to the existing proxy mechanisms. The implementation borrows from the Doctrine ORM approach and introduces a new PropertyAccessor system to handle property access uniformly across different scenarios.

• Introduces native lazy objects support for PHP 8.4+ as a replacement for existing proxy systems
• Replaces the reflection-based property access with a new PropertyAccessor architecture
• Adds comprehensive test coverage for property hooks and lazy object functionality

Reviewed Changes

Copilot reviewed 46 out of 46 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
lib/Doctrine/ODM/MongoDB/Configuration.php	Adds configuration methods for enabling native lazy objects
lib/Doctrine/ODM/MongoDB/Proxy/Factory/NativeLazyObjectFactory.php	New factory for creating native lazy objects in PHP 8.4+
lib/Doctrine/ODM/MongoDB/Mapping/PropertyAccessors/*.php	New PropertyAccessor system replacing direct reflection usage
lib/Doctrine/ODM/MongoDB/Mapping/ClassMetadata.php	Updated to use PropertyAccessor instead of reflection fields
lib/Doctrine/ODM/MongoDB/UnitOfWork.php	Updated for native lazy object support and PropertyAccessor usage
tests/Documents84/	New test documents for PHP 8.4 property hooks functionality

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}