ResponseDecorator

Response Decorator.

This helper class allows you to easily create decorators for the Response object.

• Full name: \Sabre\HTTP\ResponseDecorator
• This class implements: \Sabre\HTTP\ResponseInterface

Methods

__construct

Constructor.

public __construct(\Sabre\HTTP\ResponseInterface $inner): mixed

Parameters:

Parameter	Type	Description
$inner	\Sabre\HTTP\ResponseInterface

---

getStatus

Returns the current HTTP status code.

public getStatus(): int

---

getStatusText

Returns the human-readable status string.

public getStatusText(): string

In the case of a 200, this may for example be 'OK'.

---

setStatus

Sets the HTTP status code.

public setStatus(string|int $status): mixed

This can be either the full HTTP status code with human-readable string, for example: "403 I can't let you do that, Dave".

Or just the code, in which case the appropriate default message will be added.

Parameters:

Parameter	Type	Description
$status	string|int

---

__toString

Serializes the request object as a string.

public __toString(): string

This is useful for debugging purposes.

---

Inherited methods

getBodyAsStream

Returns the body as a readable stream resource.

public getBodyAsStream(): resource

Note that the stream may not be rewindable, and therefore may only be read once.

---

getBodyAsString

Returns the body as a string.

public getBodyAsString(): string

Note that because the underlying data may be based on a stream, this method could only work correctly the first time.

---

getBody

Returns the message body, as its internal representation.

public getBody(): resource|string

This could be either a string or a stream.

---

setBody

Updates the body resource with a new stream.

public setBody(resource|string|callable $body): mixed

Parameters:

Parameter	Type	Description
$body	resource|string|callable

---

getHeaders

Returns all the HTTP headers as an array.

public getHeaders(): array

Every header is returned as an array, with one or more values.

---

hasHeader

Will return true or false, depending on if a HTTP header exists.

public hasHeader(string $name): bool

Parameters:

Parameter	Type	Description
$name	string

---

getHeader

Returns a specific HTTP header, based on its name.

public getHeader(string $name): string|null

The name must be treated as case-insensitive. If the header does not exist, this method must return null.

If a header appeared more than once in a HTTP request, this method will concatenate all the values with a comma.

Note that this not make sense for all headers. Some, such as Set-Cookie cannot be logically combined with a comma. In those cases you should use getHeaderAsArray().

Parameters:

Parameter	Type	Description
$name	string

---

getHeaderAsArray

Returns a HTTP header as an array.

public getHeaderAsArray(string $name): array

For every time the HTTP header appeared in the request or response, an item will appear in the array.

If the header did not exist, this method will return an empty array.

Parameters:

Parameter	Type	Description
$name	string

---

setHeader

Updates a HTTP header.

public setHeader(string $name, string|string[] $value): mixed

The case-sensitivity of the name value must be retained as-is.

If the header already existed, it will be overwritten.

Parameters:

Parameter	Type	Description
$name	string
$value	string|string[]

---

setHeaders

Sets a new set of HTTP headers.

public setHeaders(array $headers): mixed

The headers array should contain headernames for keys, and their value should be specified as either a string or an array.

Any header that already existed will be overwritten.

Parameters:

Parameter	Type	Description
$headers	array

---

addHeader

Adds a HTTP header.

public addHeader(string $name, string|string[] $value): mixed

This method will not overwrite any existing HTTP header, but instead add another value. Individual values can be retrieved with getHeadersAsArray.

Parameters:

Parameter	Type	Description
$name	string
$value	string|string[]

---

addHeaders

Adds a new set of HTTP headers.

public addHeaders(array $headers): mixed

Any existing headers will not be overwritten.

Parameters:

Parameter	Type	Description
$headers	array

---

removeHeader

Removes a HTTP header.

public removeHeader(string $name): bool

The specified header name must be treated as case-insensitive. This method should return true if the header was successfully deleted, and false if the header did not exist.

Parameters:

Parameter	Type	Description
$name	string

---

setHttpVersion

Sets the HTTP version.

public setHttpVersion(string $version): mixed

Should be 1.0, 1.1 or 2.0.

Parameters:

Parameter	Type	Description
$version	string

---

getHttpVersion

Returns the HTTP version.

public getHttpVersion(): string

---

---

Automatically generated on 2025-03-18