vendor/symfony/http-kernel/Fragment/FragmentHandler.php line 85

Open in your IDE?
  1. <?php
  2. /*
  3.  * This file is part of the Symfony package.
  4.  *
  5.  * (c) Fabien Potencier <fabien@symfony.com>
  6.  *
  7.  * For the full copyright and license information, please view the LICENSE
  8.  * file that was distributed with this source code.
  9.  */
  10. namespace Symfony\Component\HttpKernel\Fragment;
  11. use Symfony\Component\HttpFoundation\RequestStack;
  12. use Symfony\Component\HttpFoundation\Response;
  13. use Symfony\Component\HttpFoundation\StreamedResponse;
  14. use Symfony\Component\HttpKernel\Controller\ControllerReference;
  15. use Symfony\Component\HttpKernel\Exception\HttpException;
  16. /**
  17.  * Renders a URI that represents a resource fragment.
  18.  *
  19.  * This class handles the rendering of resource fragments that are included into
  20.  * a main resource. The handling of the rendering is managed by specialized renderers.
  21.  *
  22.  * @author Fabien Potencier <fabien@symfony.com>
  23.  *
  24.  * @see FragmentRendererInterface
  25.  */
  26. class FragmentHandler
  27. {
  28.     private $debug;
  29.     private $renderers = [];
  30.     private $requestStack;
  31.     /**
  32.      * @param FragmentRendererInterface[] $renderers An array of FragmentRendererInterface instances
  33.      * @param bool                        $debug     Whether the debug mode is enabled or not
  34.      */
  35.     public function __construct(RequestStack $requestStack, array $renderers = [], bool $debug false)
  36.     {
  37.         $this->requestStack $requestStack;
  38.         foreach ($renderers as $renderer) {
  39.             $this->addRenderer($renderer);
  40.         }
  41.         $this->debug $debug;
  42.     }
  43.     /**
  44.      * Adds a renderer.
  45.      */
  46.     public function addRenderer(FragmentRendererInterface $renderer)
  47.     {
  48.         $this->renderers[$renderer->getName()] = $renderer;
  49.     }
  50.     /**
  51.      * Renders a URI and returns the Response content.
  52.      *
  53.      * Available options:
  54.      *
  55.      *  * ignore_errors: true to return an empty string in case of an error
  56.      *
  57.      * @param string|ControllerReference $uri A URI as a string or a ControllerReference instance
  58.      *
  59.      * @return string|null
  60.      *
  61.      * @throws \InvalidArgumentException when the renderer does not exist
  62.      * @throws \LogicException           when no main request is being handled
  63.      */
  64.     public function render($uristring $renderer 'inline', array $options = [])
  65.     {
  66.         if (!isset($options['ignore_errors'])) {
  67.             $options['ignore_errors'] = !$this->debug;
  68.         }
  69.         if (!isset($this->renderers[$renderer])) {
  70.             throw new \InvalidArgumentException(sprintf('The "%s" renderer does not exist.'$renderer));
  71.         }
  72.         if (!$request $this->requestStack->getCurrentRequest()) {
  73.             throw new \LogicException('Rendering a fragment can only be done when handling a Request.');
  74.         }
  75.         return $this->deliver($this->renderers[$renderer]->render($uri$request$options));
  76.     }
  77.     /**
  78.      * Delivers the Response as a string.
  79.      *
  80.      * When the Response is a StreamedResponse, the content is streamed immediately
  81.      * instead of being returned.
  82.      *
  83.      * @return string|null The Response content or null when the Response is streamed
  84.      *
  85.      * @throws \RuntimeException when the Response is not successful
  86.      */
  87.     protected function deliver(Response $response)
  88.     {
  89.         if (!$response->isSuccessful()) {
  90.             $responseStatusCode $response->getStatusCode();
  91.             throw new \RuntimeException(sprintf('Error when rendering "%s" (Status code is %d).'$this->requestStack->getCurrentRequest()->getUri(), $responseStatusCode), 0, new HttpException($responseStatusCode));
  92.         }
  93.         if (!$response instanceof StreamedResponse) {
  94.             return $response->getContent();
  95.         }
  96.         $response->sendContent();
  97.         return null;
  98.     }
  99. }