File tree Expand file tree Collapse file tree 1 file changed +3
-8
lines changed Expand file tree Collapse file tree 1 file changed +3
-8
lines changed Original file line number Diff line number Diff line change @@ -76,20 +76,15 @@ Template Configuration
7676 Don't use the ``@Template() `` annotation to configure the template used by
7777 the controller.
7878
79- The ``@Template `` annotation is useful, but also involves some magic. For
80- that reason, we don't recommend using it.
79+ The ``@Template `` annotation is useful, but also involves some magic. We
80+ don't think its benefit is worth the magic, and so recommend against using
81+ it.
8182
8283Most of the time, ``@Template `` is used without any parameters, which makes
8384it more difficult to know which template is being rendered. It also makes
8485it less obvious to beginners that a controller should always return a Response
8586object (unless you're using a view layer).
8687
87- Lastly, the ``@Template `` annotation uses a ``TemplateListener `` class that hooks
88- into the ``kernel.view `` event dispatched by the framework. This listener introduces
89- a measurable performance impact. In the sample blog application, rendering the
90- homepage took 5 milliseconds using the ``$this->render() `` method and 26 milliseconds
91- using the ``@Template `` annotation.
92-
9388How the Controller Looks
9489------------------------
9590
You can’t perform that action at this time.
0 commit comments