Response

class Response implements ArrayAccess (View source)

Traits

Properties

static protected array	$macros	The registered string macros.	from Macroable
protected ResponseInterface	$response	The underlying PSR response.
protected array	$decoded	The decoded JSON response.

Methods

static void

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

from Macroable

static void

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

Mix another object into the class.

from Macroable

static bool

hasMacro(string $name)

Checks if macro is registered.

from Macroable

static void

flushMacros()

Flush the existing macros.

from Macroable

static mixed

__callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

from Macroable

mixed

__call(string $method, array $parameters)

Dynamically proxy other methods to the underlying response.

void

__construct(MessageInterface $response)

Create a new response instance.

string

body()

Get the body of the response.

mixed

json(string|null $key = null, mixed $default = null)

Get the JSON decoded body of the response as an array or scalar value.

object

object()

Get the JSON decoded body of the response as an object.

Collection

collect(string|null $key = null)

Get the JSON decoded body of the response as a collection.

string

header(string $header)

Get a header from the response.

array

headers()

Get the headers from the response.

int

status()

Get the status code of the response.

string

reason()

Get the reason phrase of the response.

UriInterface|null

effectiveUri()

Get the effective URI of the response.

bool

successful()

Determine if the request was successful.

bool

ok()

Determine if the response code was "OK".

bool

redirect()

Determine if the response was a redirect.

bool

unauthorized()

Determine if the response was a 401 "Unauthorized" response.

bool

forbidden()

Determine if the response was a 403 "Forbidden" response.

bool

failed()

Determine if the response indicates a client or server error occurred.

bool

clientError()

Determine if the response indicates a client error occurred.

bool

serverError()

Determine if the response indicates a server error occurred.

$this

onError(callable $callback)

Execute the given callback if there was a server or client error.

CookieJar

cookies()

Get the response cookies.

array

handlerStats()

Get the handler stats of the response.

$this

close()

Close the stream and any underlying resources.

ResponseInterface

toPsrResponse()

Get the underlying PSR response for the response.

RequestException|null

toException()

Create an exception if a server or client error occurred.

$this

throw()

Throw an exception if a server or client error occurred.

$this

throwIf(bool $condition)

Throw an exception if a server or client error occurred and the given condition evaluates to true.

bool

offsetExists(string $offset)

Determine if the given offset exists.

mixed

offsetGet(string $offset)

Get the value for a given offset.

void

offsetSet(string $offset, mixed $value)

Set the value at the given offset.

void

offsetUnset(string $offset)

Unset the value at the given offset.

string

__toString()

Get the body of the response.

Details

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

Parameters

string	$name
object\|callable	$macro

Return Value

void

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

Mix another object into the class.

Parameters

object	$mixin
bool	$replace

Return Value

void

Exceptions

ReflectionException

static bool hasMacro(string $name)

Checks if macro is registered.

Parameters

string

$name

Return Value

bool

static void flushMacros()

Flush the existing macros.

Return Value

void

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

Dynamically handle calls to the class.

Parameters

string	$method
array	$parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $parameters)

Dynamically proxy other methods to the underlying response.

Parameters

string	$method
array	$parameters

Return Value

mixed

void __construct(MessageInterface $response)

Create a new response instance.

Parameters

MessageInterface

$response

Return Value

void

string body()

Get the body of the response.

Return Value

string

mixed json(string|null $key = null, mixed $default = null)

Get the JSON decoded body of the response as an array or scalar value.

Parameters

string\|null	$key
mixed	$default

Return Value

mixed

object object()

Get the JSON decoded body of the response as an object.

Return Value

object

Collection collect(string|null $key = null)

Get the JSON decoded body of the response as a collection.

Parameters

string|null

$key

Return Value

Collection

string header(string $header)

Get a header from the response.

Parameters

string

$header

Return Value

string

array headers()

Get the headers from the response.

Return Value

array

int status()

Get the status code of the response.

Return Value

int

string reason()

Get the reason phrase of the response.

Return Value

string

UriInterface|null effectiveUri()

Get the effective URI of the response.

Return Value

UriInterface|null

bool successful()

Determine if the request was successful.

Return Value

bool

bool ok()

Determine if the response code was "OK".

Return Value

bool

bool redirect()

Determine if the response was a redirect.

Return Value

bool

bool unauthorized()

Determine if the response was a 401 "Unauthorized" response.

Return Value

bool

bool forbidden()

Determine if the response was a 403 "Forbidden" response.

Return Value

bool

bool failed()

Determine if the response indicates a client or server error occurred.

Return Value

bool

bool clientError()

Determine if the response indicates a client error occurred.

Return Value

bool

bool serverError()

Determine if the response indicates a server error occurred.

Return Value

bool

$this onError(callable $callback)

Execute the given callback if there was a server or client error.

Parameters

callable

$callback

Return Value

$this

CookieJar cookies()

Get the response cookies.

Return Value

CookieJar

array handlerStats()

Get the handler stats of the response.

Return Value

array

$this close()

Close the stream and any underlying resources.

Return Value

$this

ResponseInterface toPsrResponse()

Get the underlying PSR response for the response.

Return Value

ResponseInterface

RequestException|null toException()

Create an exception if a server or client error occurred.

Return Value

RequestException|null

$this throw()

Throw an exception if a server or client error occurred.

Return Value

$this

Exceptions

RequestException

$this throwIf(bool $condition)

Throw an exception if a server or client error occurred and the given condition evaluates to true.

Parameters

bool

$condition

Return Value

$this

Exceptions

RequestException

bool offsetExists(string $offset)

Determine if the given offset exists.

Parameters

string

$offset

Return Value

bool

mixed offsetGet(string $offset)

Get the value for a given offset.

Parameters

string

$offset

Return Value

mixed

void offsetSet(string $offset, mixed $value)

Set the value at the given offset.

Parameters

string	$offset
mixed	$value

Return Value

void

Exceptions

LogicException

void offsetUnset(string $offset)

Unset the value at the given offset.

Parameters

string

$offset

Return Value

void

Exceptions

LogicException

string __toString()

Get the body of the response.

Return Value

string

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/8.x/Illuminate/Http/Client/Response.html