Skip to content

Commit 5c17242

Browse files
committed
minor #13444 Shortening the lenghty Xdebug explanation (ThomasLandauer)
This PR was merged into the 3.4 branch. Discussion ---------- Shortening the lenghty Xdebug explanation Done with the first section :-) Commits ------- e0ec8d9 Shortening the lenghty Xdebug explanation
2 parents f8a8eeb + e0ec8d9 commit 5c17242

File tree

1 file changed

+9
-21
lines changed

1 file changed

+9
-21
lines changed

form/form_collections.rst

Lines changed: 9 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -201,32 +201,20 @@ to render them:
201201

202202
{# ... #}
203203

204-
When the user submits the form, the submitted data for the ``tags`` field are
204+
When the user submits the form, the submitted data for the ``tags`` field is
205205
used to construct an ``ArrayCollection`` of ``Tag`` objects, which is then set
206-
on the ``tag`` field of the ``Task`` instance.
206+
on the ``tag`` field of the ``Task``. It can be accessed via ``$task->getTags()``.
207207

208-
The ``tags`` collection is accessible naturally via ``$task->getTags()``
209-
and can be persisted to the database or used however you need.
210-
211-
So far, this works great, but this doesn't allow you to dynamically add new
212-
tags or delete existing tags. So, while editing existing tags will work
213-
great, your user can't actually add any new tags yet.
208+
So far, this works great, but only to edit *existing* tags. It doesn't allow us
209+
yet to add new tags or delete existing ones.
214210

215211
.. caution::
216212

217-
In this article, you embed only one collection, but you are not limited
218-
to this. You can also embed nested collection as many levels down as you
219-
like. But if you use Xdebug in your development setup, you may receive
220-
a ``Maximum function nesting level of '100' reached, aborting!`` error.
221-
This is due to the ``xdebug.max_nesting_level`` PHP setting, which defaults
222-
to ``100``.
223-
224-
This directive limits recursion to 100 calls which may not be enough for
225-
rendering the form in the template if you render the whole form at
226-
once (e.g ``form_widget(form)``). To fix this you can set this directive
227-
to a higher value (either via a ``php.ini`` file or via :phpfunction:`ini_set`,
228-
for example in ``app/autoload.php``) or render each form field by hand
229-
using ``form_row()``.
213+
You can embed nested collections as many levels down as you like. However,
214+
if you use Xdebug, you may receive a ``Maximum function nesting level of '100'
215+
reached, aborting!`` error. To fix this, increase the ``xdebug.max_nesting_level``
216+
PHP setting, or render each form field by hand using ``form_row()`` instead of
217+
rendering the whole form at once (e.g ``form_widget(form)``).
230218

231219
.. _form-collections-new-prototype:
232220

0 commit comments

Comments
 (0)