From ac03c9d851193cfa34b01cec1b35e73081b0e0f8 Mon Sep 17 00:00:00 2001 From: Benjamin Eberlei Date: Tue, 16 Jun 2015 21:11:29 +0200 Subject: [PATCH] Add section about entities, proxies and reflection to "Limitations and Known Issues" chapter. --- .../limitations-and-known-issues.rst | 26 +++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/en/reference/limitations-and-known-issues.rst b/docs/en/reference/limitations-and-known-issues.rst index 49976f12b..8322919d4 100644 --- a/docs/en/reference/limitations-and-known-issues.rst +++ b/docs/en/reference/limitations-and-known-issues.rst @@ -83,10 +83,8 @@ Currently there is no way to overwrite the persister implementation for a given entity, however there are several use-cases that can benefit from custom persister implementations: - - `Add Upsert Support `_ - `Evaluate possible ways in which stored-procedures can be used `_ -- The previous Filter Rules Feature Request Persist Keys of Collections ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -182,3 +180,27 @@ MySQL with MyISAM tables Doctrine cannot provide atomic operations when calling ``EntityManager#flush()`` if one of the tables involved uses the storage engine MyISAM. You must use InnoDB or other storage engines that support transactions if you need integrity. + +Entities, Proxies and Reflection +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Using methods for Reflection on entities can be prone to error, when the entity +is actually a proxy the following methods will not work correctly: + +- ``new ReflectionClass`` +- ``new ReflectionObject`` +- ``get_class()`` +- ``get_parent_class()`` + +This is why ``Doctrine\Common\Util\ClassUtils`` class exists that has similar +methods, which resolve the proxy problem beforehand. + +.. code-block:: php + + getReference('Acme\Book'); + + $reflection = ClassUtils::newReflectionClass($bookProxy); + $class = ClassUtils::getClass($bookProxy)ΒΈ