diff --git a/en/reference/limitations-and-known-issues.rst b/en/reference/limitations-and-known-issues.rst index 0a7df425b..3e98ef3ff 100644 --- a/en/reference/limitations-and-known-issues.rst +++ b/en/reference/limitations-and-known-issues.rst @@ -173,6 +173,38 @@ DQL and Repository/Persister generated queries, but as this is a pretty important feature we plan to add support for it in the future. +Restricing Associations +~~~~~~~~~~~~~~~~~~~~~~~ + +There is currently no way to restrict associations to a subset of entities matching a given condition. +You should use a DQL query to retrieve a subset of associated entities. For example +if you need all visible articles in a certain category you could have the following code +in an entity repository: + +.. code-block:: php + + getEntityManager() + ->createQuery($dql) + ->setParameter(1, $category) + ->getResult(); + } + } + +Cascade Merge with Bi-directional Associations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are two bugs now that concern the use of cascade merge in combination with bi-directional associations. +Make sure to study the behavior of cascade merge if you are using it: + +- `DDC-875 Merge can sometimes add the same entity twice into a collection`_ +- `DDC-763 Cascade merge on associated entities can insert too many rows through "Persistence by Reachability"`_ + Custom Persisters ~~~~~~~~~~~~~~~~~ @@ -187,6 +219,17 @@ benefit from custom persister implementations: - `Evaluate possible ways in which stored-procedures can be used `_ - The previous Filter Rules Feature Request +Paginating Associations +~~~~~~~~~~~~~~~~~~~~~~~ + +It is not possible to paginate only parts of an associations at the moment. You can always only +load the whole association/collection into memory. This is rather problematic for large collections, +but we already plan to add facilities to fix this for Doctrine 2.1 + +- `DDC-546 New Fetch Mode EXTRA_LAZY `_ +- `Blog: Working with large collections (Workaround) `_ +- `LargeCollections Helper `_ + Persist Keys of Collections ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -213,10 +256,11 @@ in the core library. We don't think behaviors add more value than they cost pain and debugging hell. Please see the many different blog posts we have written on this topics: - - `Doctrine2 "Behaviors" in a Nutshell `_ - `A re-usable Versionable behavior for Doctrine2 `_ - `Write your own ORM on top of Doctrine2 `_ +- `Doctrine 2 Behavioral Extensions`_ +- `Doctrator_ Doctrine 2 has enough hooks and extension points so that *you* can add whatever you want on top of it. None of this will ever become @@ -264,4 +308,3 @@ support all CRUD operations on views that semantically map to certain tables. You can create views for all your problematic tables and column names to avoid the legacy quoting nightmare. -