Added a note about the side effects of enabling both PHP and Twig

javiereguiluz · javiereguiluz · commit 382816247ac1 · 2014-09-12T15:39:49.000+02:00
diff --git a/cookbook/templating/PHP.rst b/cookbook/templating/PHP.rst
@@ -77,6 +77,24 @@ shortcut to render the default ``AcmeHelloBundle:Hello:index.html.php`` template
         return array('name' => $name);
     }
 
+.. caution::
+
+    Enabling the ``php`` and ``twig`` template engines simultaneously is
+    allowed but it will produce an important side effect in your application:
+    template namespaces will no longer work::
+
+        public function indexAction()
+        {
+            // ...
+
+            // namespaced templates will no longer work
+            $this->render('@Acme/Default/index.html.twig');
+
+            // traditional template notation will work
+            $this->render('AcmeBundle:Default:index.html.twig');
+        }
+
+
 .. index::
   single: Templating; Layout
   single: Layout
