vendor/symfony/http-foundation/RedirectResponse.php line 19

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\HttpFoundation;
  14. /**
  15.  * RedirectResponse represents an HTTP response doing a redirect.
  16.  *
  17.  * @author Fabien Potencier <fabien@symfony.com>
  18.  */
  19. class RedirectResponse extends Response
  20. {
  21.     protected $targetUrl;
  23.     /**
  24.      * Creates a redirect response so that it conforms to the rules defined for a redirect status code.
  25.      *
  26.      * @param string $url     The URL to redirect to. The URL should be a full URL, with schema etc.,
  27.      *                        but practically every browser redirects on paths only as well
  28.      * @param int    $status  The HTTP status code (302 "Found" by default)
  29.      * @param array  $headers The headers (Location is always set to the given URL)
  30.      *
  31.      * @throws \InvalidArgumentException
  32.      *
  33.      * @see https://tools.ietf.org/html/rfc2616#section-10.3
  34.      */
  35.     public function __construct(string $url, int $status = 302, array $headers = [])
  36.     {
  37.         parent::__construct('', $status, $headers);
  39.         $this->setTargetUrl($url);
  41.         if (!$this->isRedirect()) {
  42.             throw new \InvalidArgumentException(sprintf('The HTTP status code is not a redirect ("%s" given).', $status));
  43.         }
  45.         if (301 == $status && !\array_key_exists('cache-control', array_change_key_case($headers, \CASE_LOWER))) {
  46.             $this->headers->remove('cache-control');
  47.         }
  48.     }
  50.     /**
  51.      * Returns the target URL.
  52.      */
  53.     public function getTargetUrl(): string
  54.     {
  55.         return $this->targetUrl;
  56.     }
  58.     /**
  59.      * Sets the redirect target of this response.
  60.      *
  61.      * @return $this
  62.      *
  63.      * @throws \InvalidArgumentException
  64.      */
  65.     public function setTargetUrl(string $url): static
  66.     {
  67.         if ('' === $url) {
  68.             throw new \InvalidArgumentException('Cannot redirect to an empty URL.');
  69.         }
  71.         $this->targetUrl = $url;
  73.         $this->setContent(
  74.             sprintf('<!DOCTYPE html>
  75. <html>
  76.     <head>
  77.         <meta charset="UTF-8" />
  78.         <meta http-equiv="refresh" content="0;url=\'%1$s\'" />
  80.         <title>Redirecting to %1$s</title>
  81.     </head>
  82.     <body>
  83.         Redirecting to <a href="%1$s">%1$s</a>.
  84.     </body>
  85. </html>', htmlspecialchars($url, \ENT_QUOTES, 'UTF-8')));
  87.         $this->headers->set('Location', $url);
  89.         return $this;
  90.     }
  91. }