class Response extends Response

Traits

Properties

static protected array $macros

The registered string macros.

from  Macroable
mixed $original

The original content of the response.

from  ResponseTrait
Throwable|null $exception

The exception that triggered the error response (if applicable).

from  ResponseTrait

Methods

static void
macro(string $name, callable|object $macro)

Register a custom macro.

static void
mixin(object $mixin, bool $replace = true)

Mix another object into the class.

static bool
hasMacro(string $name)

Check if macro is registered.

static void
flushMacros()

Flush the existing macros.

static mixed
__callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

mixed
__call(string $method, array $parameters)

Dynamically handle calls to the class.

int
status()

Get the status code for the response.

string
statusText()

Get the status text for the response.

string
content()

Get the content of the response.

mixed
getOriginalContent()

Get the original response content.

header(string $key, array|string $values, bool $replace = true)

Set a header on the Response.

withHeaders(HeaderBag|array $headers)

Add an array of headers to the response.

withoutHeader(array|string $key)

Remove a header(s) from the response.

cookie(mixed $cookie)

Add a cookie to the response.

withCookie(mixed $cookie)

Add a cookie to the response.

withoutCookie(mixed $cookie, string|null $path = null, string|null $domain = null)

Expire a cookie when sending the response.

string|null
getCallback()

Get the callback of the response.

withException(Throwable $e)

Set the exception to attach to the response.

never
throwResponse()

Throw the response in a HttpResponseException instance.

__construct(mixed $content = '', int $status = 200, array $headers = [])

Create a new HTTP response.

string|false
getContent()

Get the response content.

setContent(mixed $content)

Set the content on the response.

bool
shouldBeJson(mixed $content)

Determine if the given content should be turned into JSON.

string|false
morphToJson(mixed $content)

Morph the given content into JSON.

sendHeaders(int|null $statusCode = null)

Send HTTP headers.

sendContent()

Send response content.

send(bool $flush = true)

Send HTTP headers and content.

static void
flushState()

Flush all static state.

Details

in Macroable at line 28
static void macro(string $name, callable|object $macro)

Register a custom macro.

Boot-only. Macros persist in a static property for the worker lifetime and apply to every subsequent call on the macroable class.

Parameters

string $name
callable|object $macro

Return Value

void

in Macroable at line 41
static void mixin(object $mixin, bool $replace = true)

Mix another object into the class.

Boot-only. Delegates to macro() for each method; registered macros persist in a static property for the worker lifetime.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

in Macroable at line 57
static bool hasMacro(string $name)

Check if macro is registered.

Parameters

string $name

Return Value

bool

in Macroable at line 68
static void flushMacros()

Flush the existing macros.

Boot or tests only. Clears worker-wide macros; concurrent coroutines may resolve different methods depending on timing.

Return Value

void

in Macroable at line 78
static mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

in Macroable at line 103
mixed __call(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

in ResponseTrait at line 26
int status()

Get the status code for the response.

Return Value

int

in ResponseTrait at line 34
string statusText()

Get the status text for the response.

Return Value

string

in ResponseTrait at line 42
string content()

Get the content of the response.

Return Value

string

in ResponseTrait at line 50
mixed getOriginalContent()

Get the original response content.

Return Value

mixed

in ResponseTrait at line 62
ResponseTrait header(string $key, array|string $values, bool $replace = true)

Set a header on the Response.

Parameters

string $key
array|string $values
bool $replace

Return Value

ResponseTrait

in ResponseTrait at line 74
ResponseTrait withHeaders(HeaderBag|array $headers)

Add an array of headers to the response.

Parameters

HeaderBag|array $headers

Return Value

ResponseTrait

in ResponseTrait at line 92
ResponseTrait withoutHeader(array|string $key)

Remove a header(s) from the response.

Parameters

array|string $key

Return Value

ResponseTrait

Add a cookie to the response.

Parameters

mixed $cookie

Return Value

ResponseTrait

in ResponseTrait at line 116
ResponseTrait withCookie(mixed $cookie)

Add a cookie to the response.

Parameters

mixed $cookie

Return Value

ResponseTrait

in ResponseTrait at line 132
ResponseTrait withoutCookie(mixed $cookie, string|null $path = null, string|null $domain = null)

Expire a cookie when sending the response.

Parameters

mixed $cookie
string|null $path
string|null $domain

Return Value

ResponseTrait

in ResponseTrait at line 146
string|null getCallback()

Get the callback of the response.

Return Value

string|null

in ResponseTrait at line 156
ResponseTrait withException(Throwable $e)

Set the exception to attach to the response.

Parameters

Throwable $e

Return Value

ResponseTrait

in ResponseTrait at line 168
never throwResponse()

Throw the response in a HttpResponseException instance.

Return Value

never

Exceptions

HttpResponseException

at line 30
__construct(mixed $content = '', int $status = 200, array $headers = [])

Create a new HTTP response.

Parameters

mixed $content
int $status
array $headers

Exceptions

InvalidArgumentException

at line 42
string|false getContent()

Get the response content.

Return Value

string|false

at line 53
Response setContent(mixed $content)

Set the content on the response.

Parameters

mixed $content

Return Value

Response

Exceptions

InvalidArgumentException

at line 86
protected bool shouldBeJson(mixed $content)

Determine if the given content should be turned into JSON.

Parameters

mixed $content

Return Value

bool

at line 98
protected string|false morphToJson(mixed $content)

Morph the given content into JSON.

Parameters

mixed $content

Return Value

string|false

at line 115
Response sendHeaders(int|null $statusCode = null)

Send HTTP headers.

Parameters

int|null $statusCode

Return Value

Response

Exceptions

RuntimeException

at line 126
Response sendContent()

Send response content.

Return Value

Response

Exceptions

RuntimeException

at line 137
Response send(bool $flush = true)

Send HTTP headers and content.

Parameters

bool $flush

Return Value

Response

Exceptions

RuntimeException

at line 146
static void flushState()

Flush all static state.

Return Value

void