bug symfony#5251 [Cookbook][Controller] replace docs for removed forward() method (xabbuh)

weaverryan · weaverryan · commit f6db30eb3523 · 2015-05-23T14:53:23.000-04:00
This PR was merged into the 2.3 branch. Discussion ---------- [Cookbook][Controller] replace docs for removed `forward()` method | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no | Applies to | all | Fixed tickets | symfony/symfony#8783 The `forward()` method was removed from the `HttpKernel` class in the FrameworkBundle in Symfony 2.3. Instead, the current request needs to be duplicated and handled by the kernel's `handle()` method. Commits ------- bd62078 replace docs for removed `forward()` method
diff --git a/cookbook/controller/service.rst b/cookbook/controller/service.rst
@@ -258,7 +258,13 @@ controller:
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::forward` (service: ``http_kernel``)
     .. code-block:: php
 
-        $httpKernel->forward($controller, $path, $query);
+        use Symfony\Component\HttpKernel\HttpKernelInterface;
+        // ...
+
+        $request = ...;
+        $attributes = array_merge($path, array('_controller' => $controller));
+        $subRequest = $request->duplicate($query, null, $attributes);
+        $httpKernel->handle($subRequest, HttpKernelInterface::SUB_REQUEST);
 
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::generateUrl` (service: ``router``)
     .. code-block:: php
