response.php 3.63 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
<?php namespace System;

class Response {

	/**
	 * The content of the response.
	 *
	 * @var mixed
	 */
	public $content;

	/**
13
	 * The HTTP status code of the response.
14 15 16 17 18 19 20 21 22 23
	 *
	 * @var int
	 */
	public $status;

	/**
	 * The response headers.
	 *
	 * @var array
	 */
24
	public $headers = array();
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104

	/**
	 * HTTP status codes.
	 *
	 * @var array
	 */
	private $statuses = array(
		100 => 'Continue',
		101 => 'Switching Protocols',
		200 => 'OK',
		201 => 'Created',
		202 => 'Accepted',
		203 => 'Non-Authoritative Information',
		204 => 'No Content',
		205 => 'Reset Content',
		206 => 'Partial Content',
		207 => 'Multi-Status',
		300 => 'Multiple Choices',
		301 => 'Moved Permanently',
		302 => 'Found',
		303 => 'See Other',
		304 => 'Not Modified',
		305 => 'Use Proxy',
		307 => 'Temporary Redirect',
		400 => 'Bad Request',
		401 => 'Unauthorized',
		402 => 'Payment Required',
		403 => 'Forbidden',
		404 => 'Not Found',
		405 => 'Method Not Allowed',
		406 => 'Not Acceptable',
		407 => 'Proxy Authentication Required',
		408 => 'Request Timeout',
		409 => 'Conflict',
		410 => 'Gone',
		411 => 'Length Required',
		412 => 'Precondition Failed',
		413 => 'Request Entity Too Large',
		414 => 'Request-URI Too Long',
		415 => 'Unsupported Media Type',
		416 => 'Requested Range Not Satisfiable',
		417 => 'Expectation Failed',
		422 => 'Unprocessable Entity',
		423 => 'Locked',
		424 => 'Failed Dependency',
		500 => 'Internal Server Error',
		501 => 'Not Implemented',
		502 => 'Bad Gateway',
		503 => 'Service Unavailable',
		504 => 'Gateway Timeout',
		505 => 'HTTP Version Not Supported',
		507 => 'Insufficient Storage',
		509 => 'Bandwidth Limit Exceeded'
	);

	/**
	 * Create a new response instance.
	 *
	 * @param  mixed  $content
	 * @param  int    $status
	 */	
	public function __construct($content, $status = 200)
	{
		$this->content = $content;
		$this->status = $status;		
	}	

	/**
	 * Factory for creating new response instances.
	 *
	 * @param  string    $content
	 * @param  int       $status
	 * @return Response
	 */
	public static function make($content, $status = 200)
	{
		return new static($content, $status);
	}

	/**
105
	 * Take a value returned by a route and prepare a Response instance.
106
	 *
107
	 * @param  mixed     $response
108 109
	 * @return Response
	 */
110
	public static function prepare($response)
111
	{
112 113 114 115 116 117
		if ($response instanceof Redirect)
		{
			$response = $response->response;
		}

		return ( ! $response instanceof Response) ? new static($response) : $response;
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
	}

	/**
	 * Send the response to the browser.
	 *
	 * @return void
	 */
	public function send()
	{
		if ( ! array_key_exists('Content-Type', $this->headers))
		{
			$this->header('Content-Type', 'text/html; charset=utf-8');
		}

		if ( ! headers_sent())
		{
134
			$this->send_headers();
135 136 137 138 139 140
		}

		echo (string) $this->content;
	}

	/**
141
	 * Send the response headers to the browser.
142
	 *
143
	 * @return void
144
	 */
145
	public function send_headers()
146
	{
147 148 149 150 151 152 153 154
		$protocol = (isset($_SERVER['SERVER_PROTOCOL'])) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.1';

		header($protocol.' '.$this->status.' '.$this->statuses[$this->status]);

		foreach ($this->headers as $name => $value)
		{	
			header($name.': '.$value, true);
		}
155 156 157
	}

	/**
158
	 * Add a header to the response.
159
	 *
160 161
	 * @param  string    $name
	 * @param  string    $value
162 163
	 * @return Response
	 */
164
	public function header($name, $value)
165
	{
166
		$this->headers[$name] = $value;
167 168 169 170 171 172 173 174 175 176 177 178 179
		return $this;
	}

	/**
	 * Determine if the response is a redirect.
	 *
	 * @return bool
	 */
	public function is_redirect()
	{
		return $this->status == 301 or $this->status == 302;
	}

180 181 182 183 184 185 186 187
	/**
	 * Get the parsed content of the Response.
	 */
	public function __toString()
	{
		return (string) $this->content;
	}

188
}