Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. InlineFragmentRenderer.php

class InlineFragmentRenderer

Implements the inline rendering strategy where the Request is rendered by the current HTTP kernel.

@author Fabien Potencier <fabien@symfony.com>

Hierarchy

  • class \Symfony\Component\HttpKernel\Fragment\RoutableFragmentRenderer implements \Symfony\Component\HttpKernel\Fragment\FragmentRendererInterface
    • class \Symfony\Component\HttpKernel\Fragment\InlineFragmentRenderer extends \Symfony\Component\HttpKernel\Fragment\RoutableFragmentRenderer

Expanded class hierarchy of InlineFragmentRenderer

File

vendor/symfony/http-kernel/Fragment/InlineFragmentRenderer.php, line 28

Namespace

Symfony\Component\HttpKernel\Fragment
View source
class InlineFragmentRenderer extends RoutableFragmentRenderer {
    public function __construct(HttpKernelInterface $kernel, ?EventDispatcherInterface $dispatcher = null) {
    }
    
    /**
     * Additional available options:
     *
     *  * alt: an alternative URI to render in case of an error
     */
    public function render(string|ControllerReference $uri, Request $request, array $options = []) : Response {
        $reference = null;
        if ($uri instanceof ControllerReference) {
            $reference = $uri;
            // Remove attributes from the generated URI because if not, the Symfony
            // routing system will use them to populate the Request attributes. We don't
            // want that as we want to preserve objects (so we manually set Request attributes
            // below instead)
            $attributes = $reference->attributes;
            $reference->attributes = [];
            // The request format and locale might have been overridden by the user
            foreach ([
                '_format',
                '_locale',
            ] as $key) {
                if (isset($attributes[$key])) {
                    $reference->attributes[$key] = $attributes[$key];
                }
            }
            $uri = $this->generateFragmentUri($uri, $request, false, false);
            $reference->attributes = array_merge($attributes, $reference->attributes);
        }
        $subRequest = $this->createSubRequest($uri, $request);
        // override Request attributes as they can be objects (which are not supported by the generated URI)
        if (null !== $reference) {
            $subRequest->attributes
                ->add($reference->attributes);
        }
        $level = ob_get_level();
        try {
            return SubRequestHandler::handle($this->kernel, $subRequest, HttpKernelInterface::SUB_REQUEST, false);
        } catch (\Exception $e) {
            // we dispatch the exception event to trigger the logging
            // the response that comes back is ignored
            if (isset($options['ignore_errors']) && $options['ignore_errors'] && $this->dispatcher) {
                $event = new ExceptionEvent($this->kernel, $request, HttpKernelInterface::SUB_REQUEST, $e);
                $this->dispatcher
                    ->dispatch($event, KernelEvents::EXCEPTION);
            }
            // let's clean up the output buffers that were created by the sub-request
            Response::closeOutputBuffers($level, false);
            if (isset($options['alt'])) {
                $alt = $options['alt'];
                unset($options['alt']);
                return $this->render($alt, $request, $options);
            }
            if (!isset($options['ignore_errors']) || !$options['ignore_errors']) {
                throw $e;
            }
            return new Response();
        }
    }
    protected function createSubRequest(string $uri, Request $request) : Request {
        $cookies = $request->cookies
            ->all();
        $server = $request->server
            ->all();
        unset($server['HTTP_IF_MODIFIED_SINCE']);
        unset($server['HTTP_IF_NONE_MATCH']);
        $subRequest = Request::create($uri, 'get', [], $cookies, [], $server);
        if ($request->headers
            ->has('Surrogate-Capability')) {
            $subRequest->headers
                ->set('Surrogate-Capability', $request->headers
                ->get('Surrogate-Capability'));
        }
        static $setSession;
        $setSession ??= \Closure::bind(static function ($subRequest, $request) {
            $subRequest->session = $request->session;
        }, null, Request::class);
        $setSession($subRequest, $request);
        if ($request->get('_format')) {
            $subRequest->attributes
                ->set('_format', $request->get('_format'));
        }
        if ($request->getDefaultLocale() !== $request->getLocale()) {
            $subRequest->setLocale($request->getLocale());
        }
        if ($request->attributes
            ->has('_stateless')) {
            $subRequest->attributes
                ->set('_stateless', $request->attributes
                ->get('_stateless'));
        }
        if ($request->attributes
            ->has('_check_controller_is_allowed')) {
            $subRequest->attributes
                ->set('_check_controller_is_allowed', $request->attributes
                ->get('_check_controller_is_allowed'));
        }
        return $subRequest;
    }
    public function getName() : string {
        return 'inline';
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
InlineFragmentRenderer::createSubRequest protected function
InlineFragmentRenderer::getName public function Gets the name of the strategy. Overrides FragmentRendererInterface::getName
InlineFragmentRenderer::render public function Additional available options: Overrides FragmentRendererInterface::render
InlineFragmentRenderer::__construct public function
RoutableFragmentRenderer::$fragmentPath protected property @internal
RoutableFragmentRenderer::generateFragmentUri protected function Generates a fragment URI for a given controller.
RoutableFragmentRenderer::setFragmentPath public function Sets the fragment path that triggers the fragment listener.
RSS feed
Powered by Drupal