/**
* Create an HTML response.
*
* Produces an HTML response with a Content-Type of text/html and a default
* status of 200.
*
* @param string|StreamInterface $html HTML or stream for the message body.
* @param int $status Integer status code for the response; 200 by default.
* @param array $headers Array of headers to use at initialization.
* @throws InvalidArgumentException if $html is neither a string or stream.
*/
public function __construct($html = '', $status = 200, array $headers = [])
{
parent::__construct($this->createBody($html), $status, []);
$headers = $headers + ['Content-Type' => 'text/html; charset=utf-8'];
foreach ($headers as $name => $value) {
$this->withHeader($name, $value);
}
}
/**
* Create a JSON response with the given data.
*
* Default JSON encoding is performed with the following options, which
* produces RFC4627-compliant JSON, capable of embedding into HTML.
*
* - JSON_HEX_TAG
* - JSON_HEX_APOS
* - JSON_HEX_AMP
* - JSON_HEX_QUOT
* - JSON_UNESCAPED_SLASHES
*
* @param mixed $data Data to convert to JSON.
* @param int $status Integer status code for the response; 200 by default.
* @param array $headers Array of headers to use at initialization.
* @param int $encodingOptions JSON encoding options to use.
* @throws InvalidArgumentException if unable to encode the $data to JSON.
*/
public function __construct($data = '', $status = 200, array $headers = [], $encodingOptions = self::DEFAULT_JSON_FLAGS)
{
$body = new Stream(fopen('php://temp', 'r+'));
$body->write($this->jsonEncode($data, $encodingOptions));
$body->rewind();
parent::__construct($body, $status, []);
$headers = $headers + ['Content-Type' => 'application/json'];
foreach ($headers as $name => $value) {
$this->withHeader($name, $value);
}
}
/**
* Create a redirect response.
*
* Produces a redirect response with a Location header and the given status
* (302 by default).
*
* Note: this method overwrites the `location` $headers value.
*
* @param string|UriInterface $uri URI for the Location header.
* @param int $status Integer status code for the redirect; 302 by default.
* @param array $headers Array of headers to use at initialization.
*/
public function __construct($uri, $status = 302, array $headers = [])
{
if (!is_string($uri) && !$uri instanceof UriInterface) {
throw new InvalidArgumentException(sprintf('Uri provided to %s MUST be a string or Psr\\Http\\Message\\UriInterface instance; received "%s"', __CLASS__, is_object($uri) ? get_class($uri) : gettype($uri)));
}
parent::__construct(\null, $status, []);
$headers = ['Location' => (string) $uri] + $headers;
foreach ($headers as $name => $value) {
$this->withHeader($name, $value);
}
}
public function __construct($url, $code = 302)
{
parent::__construct('', $code);
$this->setUrl($url);
}
/**
* Create an empty response with the given status code.
*
* @param int $status Status code for the response, if any.
* @param array $headers Headers for the response, if any.
*/
public function __construct($status = 204, array $headers = [])
{
parent::__construct(\null, $status, $headers);
}
