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

Open in your IDE?
  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 status code (302 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.      * Factory method for chainability.
  52.      *
  53.      * @param string $url The URL to redirect to
  54.      *
  55.      * @return static
  56.      */
  57.     public static function create($url = '', int $status = 302, array $headers = [])
  58.     {
  59.         return new static($url, $status, $headers);
  60.     }
  62.     /**
  63.      * Returns the target URL.
  64.      *
  65.      * @return string target URL
  66.      */
  67.     public function getTargetUrl()
  68.     {
  69.         return $this->targetUrl;
  70.     }
  72.     /**
  73.      * Sets the redirect target of this response.
  74.      *
  75.      * @return $this
  76.      *
  77.      * @throws \InvalidArgumentException
  78.      */
  79.     public function setTargetUrl(string $url)
  80.     {
  81.         if ('' === $url) {
  82.             throw new \InvalidArgumentException('Cannot redirect to an empty URL.');
  83.         }
  85.         $this->targetUrl = $url;
  87.         $this->setContent(
  88.             sprintf('<!DOCTYPE html>
  89. <html>
  90.     <head>
  91.         <meta charset="UTF-8" />
  92.         <meta http-equiv="refresh" content="0;url=\'%1$s\'" />
  94.         <title>Redirecting to %1$s</title>
  95.     </head>
  96.     <body>
  97.         Redirecting to <a href="%1$s">%1$s</a>.
  98.     </body>
  99. </html>', htmlspecialchars($url, ENT_QUOTES, 'UTF-8')));
  101.         $this->headers->set('Location', $url);
  103.         return $this;
  104.     }
  105. }