class RedirectResponseSubscriber

Same name in other branches
  1. 9 core/lib/Drupal/Core/EventSubscriber/RedirectResponseSubscriber.php \Drupal\Core\EventSubscriber\RedirectResponseSubscriber
  2. 8.9.x core/lib/Drupal/Core/EventSubscriber/RedirectResponseSubscriber.php \Drupal\Core\EventSubscriber\RedirectResponseSubscriber
  3. 10 core/lib/Drupal/Core/EventSubscriber/RedirectResponseSubscriber.php \Drupal\Core\EventSubscriber\RedirectResponseSubscriber

Allows manipulation of the response object when performing a redirect.

Hierarchy

  • class \Drupal\Core\EventSubscriber\RedirectResponseSubscriber implements \Symfony\Component\EventDispatcher\EventSubscriberInterface

Expanded class hierarchy of RedirectResponseSubscriber

4 files declare their use of RedirectResponseSubscriber
FormSubmitter.php in core/lib/Drupal/Core/Form/FormSubmitter.php
FormSubmitterTest.php in core/tests/Drupal/Tests/Core/Form/FormSubmitterTest.php
FormTestBase.php in core/tests/Drupal/Tests/Core/Form/FormTestBase.php
RedirectResponseSubscriberTest.php in core/tests/Drupal/Tests/Core/EventSubscriber/RedirectResponseSubscriberTest.php

File

core/lib/Drupal/Core/EventSubscriber/RedirectResponseSubscriber.php, line 20

Namespace

Drupal\Core\EventSubscriber
View source
class RedirectResponseSubscriber implements EventSubscriberInterface {
    
    /**
     * Whether to ignore the destination query parameter when redirecting.
     *
     * @var bool
     */
    protected bool $ignoreDestination = FALSE;
    
    /**
     * Constructs a RedirectResponseSubscriber object.
     *
     * @param \Drupal\Core\Utility\UnroutedUrlAssemblerInterface $unroutedUrlAssembler
     *   The unrouted URL assembler service.
     * @param \Drupal\Core\Routing\RequestContext $requestContext
     *   The request context.
     * @param \Closure $loggerClosure
     *   A closure that wraps the 'logger.channel.php' service.
     */
    public function __construct(UnroutedUrlAssemblerInterface $unroutedUrlAssembler, RequestContext $requestContext, \Closure $loggerClosure) {
    }
    
    /**
     * Allows manipulation of the response object when performing a redirect.
     *
     * @param \Symfony\Component\HttpKernel\Event\ResponseEvent $event
     *   The Event to process.
     */
    public function checkRedirectUrl(ResponseEvent $event) {
        $response = $event->getResponse();
        if ($response instanceof RedirectResponse) {
            $request = $event->getRequest();
            // Let the 'destination' query parameter override the redirect target.
            // If $response is already a SecuredRedirectResponse, it might reject the
            // new target as invalid, in which case proceed with the old target.
            $destination = $request->query
                ->get('destination');
            if ($destination && !$this->ignoreDestination) {
                // The 'Location' HTTP header must always be absolute.
                $destination = $this->getDestinationAsAbsoluteUrl($destination, $request->getSchemeAndHttpHost());
                try {
                    $response->setTargetUrl($destination);
                } catch (\InvalidArgumentException) {
                }
            }
            // Regardless of whether the target is the original one or the overridden
            // destination, ensure that all redirects are safe.
            if (!$response instanceof SecuredRedirectResponse) {
                try {
                    // SecuredRedirectResponse is an abstract class that requires a
                    // concrete implementation. Default to LocalRedirectResponse, which
                    // considers only redirects to within the same site as safe.
                    $safe_response = LocalRedirectResponse::createFromRedirectResponse($response);
                    $safe_response->setRequestContext($this->requestContext);
                } catch (\InvalidArgumentException) {
                    // If the above failed, it's because the redirect target wasn't
                    // local. Do not follow that redirect. Log an error message instead,
                    // then return a 400 response to the client with the error message.
                    // We don't throw an exception, because this is a client error rather
                    // than a server error.
                    $message = 'Redirects to external URLs are not allowed by default, use \\Drupal\\Core\\Routing\\TrustedRedirectResponse for it.';
                    
                    /** @var \Psr\Log\LoggerInterface $logger */
                    $logger = ($this->loggerClosure)();
                    $logger->error($message);
                    $safe_response = new Response($message, 400);
                }
                $event->setResponse($safe_response);
            }
        }
    }
    
    /**
     * Converts the passed in destination into an absolute URL.
     *
     * @param string $destination
     *   The path for the destination. In case it starts with a slash it should
     *   have the base path included already.
     * @param string $scheme_and_host
     *   The scheme and host string of the current request.
     *
     * @return string
     *   The destination as absolute URL.
     */
    protected function getDestinationAsAbsoluteUrl($destination, $scheme_and_host) {
        if (!UrlHelper::isExternal($destination)) {
            // The destination query parameter can be a relative URL in the sense of
            // not including the scheme and host, but its path is expected to be
            // absolute (start with a '/'). For such a case, prepend the scheme and
            // host, because the 'Location' header must be absolute.
            if (str_starts_with($destination, '/')) {
                $destination = $scheme_and_host . $destination;
            }
            else {
                // Legacy destination query parameters can be internal paths that have
                // not yet been converted to URLs.
                $destination = UrlHelper::parse($destination);
                $uri = 'base:' . $destination['path'];
                $options = [
                    'query' => $destination['query'],
                    'fragment' => $destination['fragment'],
                    'absolute' => TRUE,
                ];
                // Treat this as if it's user input of a path relative to the site's
                // base URL.
                $destination = $this->unroutedUrlAssembler
                    ->assemble($uri, $options);
            }
        }
        return $destination;
    }
    
    /**
     * Set whether the redirect response will ignore the destination query param.
     *
     * @param bool $status
     *   (optional) TRUE if the destination query parameter should be ignored.
     *   FALSE if not. Defaults to TRUE.
     */
    public function setIgnoreDestination($status = TRUE) {
        $this->ignoreDestination = $status;
    }
    
    /**
     * Registers the methods in this class that should be listeners.
     *
     * @return array
     *   An array of event listener definitions.
     */
    public static function getSubscribedEvents() : array {
        $events[KernelEvents::RESPONSE][] = [
            'checkRedirectUrl',
        ];
        return $events;
    }

}

Members

Title Sort descending Modifiers Object type Summary
RedirectResponseSubscriber::$ignoreDestination protected property Whether to ignore the destination query parameter when redirecting.
RedirectResponseSubscriber::checkRedirectUrl public function Allows manipulation of the response object when performing a redirect.
RedirectResponseSubscriber::getDestinationAsAbsoluteUrl protected function Converts the passed in destination into an absolute URL.
RedirectResponseSubscriber::getSubscribedEvents public static function Registers the methods in this class that should be listeners.
RedirectResponseSubscriber::setIgnoreDestination public function Set whether the redirect response will ignore the destination query param.
RedirectResponseSubscriber::__construct public function Constructs a RedirectResponseSubscriber object.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.