Merge branch '5.0'

javiereguiluz · javiereguiluz · commit 8899d3481bb3 · 2020-03-23T15:58:42.000+01:00
* 5.0:
  Reword
  Document RenderView method
diff --git a/templates.rst b/templates.rst
@@ -395,17 +395,29 @@ use the ``render()`` helper::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class ProductController extends AbstractController
     {
         public function index()
         {
             // ...
 
+            // the `render()` method returns a `Response` object with the
+            // contents created by the template
             return $this->render('product/index.html.twig', [
                 'category' => '...',
                 'promotions' => ['...', '...'],
             ]);
+
+            // the `renderView()` method only returns the contents created by the
+            // template, so you can use those contents later in a `Response` object
+            $contents = $this->renderView('product/index.html.twig', [
+                'category' => '...',
+                'promotions' => ['...', '...'],
+            ]);
+
+            return new Response($contents);
         }
     }
 
