setStatusCode($code, !empty($reasonPhrase) ? $reasonPhrase : null); return $new; } /** * Gets the response reason phrase associated with the status code. * * Because a reason phrase is not a required element in a response * status line, the reason phrase value MAY be null. Implementations MAY * choose to return the default RFC 7231 recommended reason phrase (or those * listed in the IANA HTTP Status Code Registry) for the response's * status code. * * @link http://tools.ietf.org/html/rfc7231#section-6 * @link http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml * @return string Reason phrase; must return an empty string if none present. */ public function getReasonPhrase(): string { return $this->statusText; } /** * Return an instance with the specified content. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * updated status and reason phrase. * * @param mixed $content Content that can be cast to string * @return static */ public function withContent(mixed $content): static { $new = clone $this; $new->setContent($content); return $new; } /** * Return an instance with the rendered content. * * This method retains the immutability of the message and returns * an instance with the updated status and headers * * @param string[]|string[][] $headers */ public function withView(string $view, array $data = [], int $status = 200, array $headers = []): Response { if (!$this->renderer instanceof Renderer) { throw new InvalidArgumentException('Renderer not defined'); } $new = clone $this; $new->setContent($this->renderer->render($view, $data)); $new->setStatusCode($status, ($status == $this->getStatusCode() ? $this->statusText : null)); foreach ($headers as $key => $values) { $new = $new->withAddedHeader($key, $values); } return $new; } /** * Return an redirect instance * * This method retains the immutability of the message and returns * an instance with the updated status and headers */ public function redirectTo(string $path, int $status = 302, array $headers = []): Response { $response = $this->withStatus($status); $response = $response->withHeader('location', $path); foreach ($headers as $name => $value) { $response = $response->withAddedHeader($name, $value); } return $response; } /** * Set the renderer to use */ public function setRenderer(Renderer $renderer): void { $this->renderer = $renderer; } /** * Sets a session attribute (which is mutable) */ public function with(string $key, mixed $value): Response { if (!$this->session instanceof SessionInterface) { throw new InvalidArgumentException('Session not defined'); } $data = $this->session->get($key); if (is_array($data) && is_array($value)) { $value = array_merge_recursive($data, $value); } $this->session->set($key, $value); return $this; } /** * Sets form data to the mutable session */ public function withInput(array $input): Response { if (!$this->session instanceof SessionInterface) { throw new InvalidArgumentException('Session not defined'); } foreach ($input as $name => $value) { $this->session->set('form-data-' . $name, $value); } return $this; } }