323 lines
7.2 KiB
PHP
323 lines
7.2 KiB
PHP
<?php namespace Laravel;
|
|
|
|
class Response_Factory {
|
|
|
|
/**
|
|
* The view factory instance.
|
|
*
|
|
* @var View_Factory
|
|
*/
|
|
protected $view;
|
|
|
|
/**
|
|
* The file manager instance.
|
|
*
|
|
* @var File
|
|
*/
|
|
protected $file;
|
|
|
|
/**
|
|
* Create a new response factory instance.
|
|
*
|
|
* @param View_Factory $view
|
|
* @param File $file
|
|
* @return void
|
|
*/
|
|
public function __construct(View_Factory $view, File $file)
|
|
{
|
|
$this->view = $view;
|
|
$this->file = $file;
|
|
}
|
|
|
|
/**
|
|
* Create a new response instance.
|
|
*
|
|
* <code>
|
|
* // Create a response instance
|
|
* return Response::make('Hello World');
|
|
*
|
|
* // Create a response instance with a given status code
|
|
* return Response::make('Hello World', 200);
|
|
* </code>
|
|
*
|
|
* @param mixed $content
|
|
* @param int $status
|
|
* @param array $headers
|
|
* @return Response
|
|
*/
|
|
public function make($content, $status = 200, $headers = array())
|
|
{
|
|
return new Response($content, $status, $headers);
|
|
}
|
|
|
|
/**
|
|
* Create a new response instance containing a view.
|
|
*
|
|
* <code>
|
|
* // Create a new response instance with view content
|
|
* return Response::view('home.index');
|
|
*
|
|
* // Create a new response instance with a view and bound data
|
|
* return Response::view('home.index', array('name' => 'Fred'));
|
|
* </code>
|
|
*
|
|
* @param string $view
|
|
* @param array $data
|
|
* @return Response
|
|
*/
|
|
public function view($view, $data = array())
|
|
{
|
|
return new Response($this->view->make($view, $data));
|
|
}
|
|
|
|
/**
|
|
* Create a new response instance containing a named view.
|
|
*
|
|
* <code>
|
|
* // Create a new response instance with a named view
|
|
* return Response::with('layout');
|
|
*
|
|
* // Create a new response instance with a named view and bound data
|
|
* return Response::with('layout', array('name' => 'Fred'));
|
|
* </code>
|
|
*
|
|
* @param string $name
|
|
* @param array $data
|
|
* @return Response
|
|
*/
|
|
public function with($name, $data = array())
|
|
{
|
|
return new Response($this->view->of($name, $data));
|
|
}
|
|
|
|
/**
|
|
* Create a new error response instance.
|
|
*
|
|
* The response status code will be set using the specified code.
|
|
*
|
|
* Note: The specified error code should correspond to a view in your views/error directory.
|
|
*
|
|
* <code>
|
|
* // Create an error response for status 500
|
|
* return Response::error('500');
|
|
* </code>
|
|
*
|
|
* @param int $code
|
|
* @param array $data
|
|
* @return Response
|
|
*/
|
|
public function error($code, $data = array())
|
|
{
|
|
return new Response($this->view->make('error/'.$code, $data), $code);
|
|
}
|
|
|
|
/**
|
|
* Create a new download response instance.
|
|
*
|
|
* @param string $path
|
|
* @param string $name
|
|
* @param array $headers
|
|
* @return Response
|
|
*/
|
|
public function download($path, $name = null, $headers = array())
|
|
{
|
|
if (is_null($name)) $name = basename($path);
|
|
|
|
$headers = array_merge(array(
|
|
'Content-Description' => 'File Transfer',
|
|
'Content-Type' => $this->file->mime($this->file->extension($path)),
|
|
'Content-Disposition' => 'attachment; filename="'.$name.'"',
|
|
'Content-Transfer-Encoding' => 'binary',
|
|
'Expires' => 0,
|
|
'Cache-Control' => 'must-revalidate, post-check=0, pre-check=0',
|
|
'Pragma' => 'public',
|
|
'Content-Length' => $this->file-size($path),
|
|
), $headers);
|
|
|
|
return new Response($this->file->get($path), 200, $headers);
|
|
}
|
|
|
|
/**
|
|
* Magic Method for handling the dynamic creation of Responses containing named views.
|
|
*
|
|
* <code>
|
|
* // Create a Response instance with the "layout" named view
|
|
* $response = Response::with_layout();
|
|
*
|
|
* // Create a Response instance with the "layout" named view and bound data
|
|
* $response = Response::with_layout(array('name' => 'Fred'));
|
|
* </code>
|
|
*/
|
|
public function __call($method, $parameters)
|
|
{
|
|
if (strpos($method, 'with_') === 0)
|
|
{
|
|
return $this->with(substr($method, 5), Arr::get($parameters, 0, array()));
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
class Response {
|
|
|
|
/**
|
|
* The content of the response.
|
|
*
|
|
* @var mixed
|
|
*/
|
|
public $content;
|
|
|
|
/**
|
|
* The HTTP status code of the response.
|
|
*
|
|
* @var int
|
|
*/
|
|
public $status;
|
|
|
|
/**
|
|
* The response headers.
|
|
*
|
|
* @var array
|
|
*/
|
|
public $headers = array();
|
|
|
|
/**
|
|
* 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
|
|
* @param array $headers
|
|
* @return void
|
|
*/
|
|
public function __construct($content, $status = 200, $headers = array())
|
|
{
|
|
$this->content = $content;
|
|
$this->headers = $headers;
|
|
$this->status = $status;
|
|
}
|
|
|
|
/**
|
|
* Get the evaluated string contents of the response.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function render()
|
|
{
|
|
return ($this->content instanceof View) ? $this->content->render() : (string) $this->content;
|
|
}
|
|
|
|
/**
|
|
* Send the response to the browser.
|
|
*
|
|
* All of the response header will be sent to the browser first, followed by
|
|
* the content of the response instance, which will be evaluated and rendered
|
|
* by the render method.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function send()
|
|
{
|
|
if ( ! isset($this->headers['Content-Type'])) $this->header('Content-Type', 'text/html; charset=utf-8');
|
|
|
|
if ( ! headers_sent()) $this->send_headers();
|
|
|
|
echo $this->render();
|
|
}
|
|
|
|
/**
|
|
* Send the response headers to the browser.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function send_headers()
|
|
{
|
|
$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);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add a header to the response.
|
|
*
|
|
* @param string $name
|
|
* @param string $value
|
|
* @return Response
|
|
*/
|
|
public function header($name, $value)
|
|
{
|
|
$this->headers[$name] = $value;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Set the response status code.
|
|
*
|
|
* @param int $status
|
|
* @return Response
|
|
*/
|
|
public function status($status)
|
|
{
|
|
$this->status = $status;
|
|
return $this;
|
|
}
|
|
|
|
} |