www.aleph1.co.uk Git - yaffs-website/blob - vendor/symfony/http-foundation/RedirectResponse.php

   1 <?php
   2
   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  */
  11
  12 namespace Symfony\Component\HttpFoundation;
  13
  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;
  22
  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 http://tools.ietf.org/html/rfc2616#section-10.3
  34      */
  35     public function __construct($url, $status = 302, $headers = array())
  36     {
  37         parent::__construct('', $status, $headers);
  38
  39         $this->setTargetUrl($url);
  40
  41         if (!$this->isRedirect()) {
  42             throw new \InvalidArgumentException(sprintf('The HTTP status code is not a redirect ("%s" given).', $status));
  43         }
  44     }
  45
  46     /**
  47      * {@inheritdoc}
  48      */
  49     public static function create($url = '', $status = 302, $headers = array())
  50     {
  51         return new static($url, $status, $headers);
  52     }
  53
  54     /**
  55      * Returns the target URL.
  56      *
  57      * @return string target URL
  58      */
  59     public function getTargetUrl()
  60     {
  61         return $this->targetUrl;
  62     }
  63
  64     /**
  65      * Sets the redirect target of this response.
  66      *
  67      * @param string $url The URL to redirect to
  68      *
  69      * @return $this
  70      *
  71      * @throws \InvalidArgumentException
  72      */
  73     public function setTargetUrl($url)
  74     {
  75         if (empty($url)) {
  76             throw new \InvalidArgumentException('Cannot redirect to an empty URL.');
  77         }
  78
  79         $this->targetUrl = $url;
  80
  81         $this->setContent(
  82             sprintf('<!DOCTYPE html>
  83 <html>
  84     <head>
  85         <meta charset="UTF-8" />
  86         <meta http-equiv="refresh" content="1;url=%1$s" />
  87
  88         <title>Redirecting to %1$s</title>
  89     </head>
  90     <body>
  91         Redirecting to <a href="%1$s">%1$s</a>.
  92     </body>
  93 </html>', htmlspecialchars($url, ENT_QUOTES, 'UTF-8')));
  94
  95         $this->headers->set('Location', $url);
  96
  97         return $this;
  98     }
  99 }