Merge branch '3.3' into 3.4

weaverryan · weaverryan · commit d7ee5d580841 · 2017-10-29T14:47:38.000-04:00
* 3.3:
  Adding warning about non-service arguments
diff --git a/controller.rst b/controller.rst
@@ -338,6 +338,13 @@ controller's service config:
 You can of course also use normal :ref:`constructor injection <services-constructor-injection>`
 in your controllers.
 
+.. caution::
+
+    You can *only* pass *services* to your controller arguments in this way. It's
+    not possible, for example, to pass a service parameter as a controller argument.
+    If you need a parameter, use the ``$this->getParameter('kernel.debug')`` shortcut
+    or pass the value through your controller's ``__construct()`` method.
+
 For more information about services, see the :doc:`/service_container` article.
 
 .. _controller-service-arguments-tag:
