Symfony2 API
Class

Symfony\Component\HttpFoundation\StreamedResponse

class StreamedResponse extends Response

StreamedResponse represents a streamed HTTP response.

A StreamedResponse uses a callback for its content.

The callback should use the standard PHP functions like echo to stream the response back to the client. The flush() method can also be used if needed.

Constants

HTTP_CONTINUE

HTTP_SWITCHING_PROTOCOLS

HTTP_PROCESSING

HTTP_OK

HTTP_CREATED

HTTP_ACCEPTED

HTTP_NON_AUTHORITATIVE_INFORMATION

HTTP_NO_CONTENT

HTTP_RESET_CONTENT

HTTP_PARTIAL_CONTENT

HTTP_MULTI_STATUS

HTTP_ALREADY_REPORTED

HTTP_IM_USED

HTTP_MULTIPLE_CHOICES

HTTP_MOVED_PERMANENTLY

HTTP_FOUND

HTTP_SEE_OTHER

HTTP_NOT_MODIFIED

HTTP_USE_PROXY

HTTP_RESERVED

HTTP_TEMPORARY_REDIRECT

HTTP_PERMANENTLY_REDIRECT

HTTP_BAD_REQUEST

HTTP_UNAUTHORIZED

HTTP_PAYMENT_REQUIRED

HTTP_FORBIDDEN

HTTP_NOT_FOUND

HTTP_METHOD_NOT_ALLOWED

HTTP_NOT_ACCEPTABLE

HTTP_PROXY_AUTHENTICATION_REQUIRED

HTTP_REQUEST_TIMEOUT

HTTP_CONFLICT

HTTP_GONE

HTTP_LENGTH_REQUIRED

HTTP_PRECONDITION_FAILED

HTTP_REQUEST_ENTITY_TOO_LARGE

HTTP_REQUEST_URI_TOO_LONG

HTTP_UNSUPPORTED_MEDIA_TYPE

HTTP_REQUESTED_RANGE_NOT_SATISFIABLE

HTTP_EXPECTATION_FAILED

HTTP_I_AM_A_TEAPOT

HTTP_UNPROCESSABLE_ENTITY

HTTP_LOCKED

HTTP_FAILED_DEPENDENCY

HTTP_RESERVED_FOR_WEBDAV_ADVANCED_COLLECTIONS_EXPIRED_PROPOSAL

HTTP_UPGRADE_REQUIRED

HTTP_PRECONDITION_REQUIRED

HTTP_TOO_MANY_REQUESTS

HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE

HTTP_INTERNAL_SERVER_ERROR

HTTP_NOT_IMPLEMENTED

HTTP_BAD_GATEWAY

HTTP_SERVICE_UNAVAILABLE

HTTP_GATEWAY_TIMEOUT

HTTP_VERSION_NOT_SUPPORTED

HTTP_VARIANT_ALSO_NEGOTIATES_EXPERIMENTAL

HTTP_INSUFFICIENT_STORAGE

HTTP_LOOP_DETECTED

HTTP_NOT_EXTENDED

HTTP_NETWORK_AUTHENTICATION_REQUIRED

Properties

ResponseHeaderBag $headers
static array $statusTexts Status codes translation table.

Methods

__construct(callable|null $callback = null, int $status = 200, array $headers = array())

Constructor.

static StreamedResponse create(callable|null $callback = null, int $status = 200, array $headers = array())

Factory method for chainability

string __toString()

Returns the Response as an HTTP string.

from Response
__clone()

Clones the current Response instance.

from Response
Response prepare(Request $request)

Prepares the Response before it is sent to the client.

from Response
Response sendHeaders()

Sends HTTP headers.

from Response
Response sendContent()

Sends content for the current web response.

Response send()

Sends HTTP headers and content.

from Response
Response setContent(mixed $content)

Sets the response content.

false getContent()

Gets the current response content.

Response setProtocolVersion(string $version)

Sets the HTTP protocol version (1.0 or 1.1).

from Response
string getProtocolVersion()

Gets the HTTP protocol version.

from Response
Response setStatusCode(int $code, mixed $text = null)

Sets the response status code.

from Response
int getStatusCode()

Retrieves the status code for the current web response.

from Response
Response setCharset(string $charset)

Sets the response charset.

from Response
string getCharset()

Retrieves the response charset.

from Response
bool isCacheable()

Returns true if the response is worth caching under any circumstance.

from Response
bool isFresh()

Returns true if the response is "fresh".

from Response
bool isValidateable()

Returns true if the response includes headers that can be used to validate the response with the origin server using a conditional GET request.

from Response
Response setPrivate()

Marks the response as "private".

from Response
Response setPublic()

Marks the response as "public".

from Response
bool mustRevalidate()

Returns true if the response must be revalidated by caches.

from Response
DateTime getDate()

Returns the Date header as a DateTime instance.

from Response
Response setDate(DateTime $date)

Sets the Date header.

from Response
int getAge()

Returns the age of the response.

from Response
Response expire()

Marks the response stale by setting the Age header to be equal to the maximum age of the response.

from Response
DateTime|null getExpires()

Returns the value of the Expires header as a DateTime instance.

from Response
Response setExpires(DateTime $date = null)

Sets the Expires HTTP header with a DateTime instance.

from Response
int|null getMaxAge()

Returns the number of seconds after the time specified in the response's Date header when the response should no longer be considered fresh.

from Response
Response setMaxAge(int $value)

Sets the number of seconds after which the response should no longer be considered fresh.

from Response
Response setSharedMaxAge(int $value)

Sets the number of seconds after which the response should no longer be considered fresh by shared caches.

from Response
int|null getTtl()

Returns the response's time-to-live in seconds.

from Response
Response setTtl(int $seconds)

Sets the response's time-to-live for shared caches.

from Response
Response setClientTtl(int $seconds)

Sets the response's time-to-live for private/client caches.

from Response
DateTime|null getLastModified()

Returns the Last-Modified HTTP header as a DateTime instance.

from Response
Response setLastModified(DateTime $date = null)

Sets the Last-Modified HTTP header with a DateTime instance.

from Response
string|null getEtag()

Returns the literal value of the ETag HTTP header.

from Response
Response setEtag(string|null $etag = null, bool $weak = false)

Sets the ETag value.

from Response
Response setCache(array $options)

Sets the response's cache headers (validation and/or expiration).

from Response
Response setNotModified()

Modifies the response so that it conforms to the rules defined for a 304 status code.

from Response
bool hasVary()

Returns true if the response includes a Vary header.

from Response
array getVary()

Returns an array of header names given in the Vary header.

from Response
Response setVary(string|array $headers, bool $replace = true)

Sets the Vary header.

from Response
bool isNotModified(Request $request)

Determines if the Response validators (ETag, Last-Modified) match a conditional value specified in the Request.

from Response
bool isInvalid()

Is response invalid?

from Response
bool isInformational()

Is response informative?

from Response
bool isSuccessful()

Is response successful?

from Response
bool isRedirection()

Is the response a redirect?

from Response
bool isClientError()

Is there a client error?

from Response
bool isServerError()

Was there a server side error?

from Response
bool isOk()

Is the response OK?

from Response
bool isForbidden()

Is the response forbidden?

from Response
bool isNotFound()

Is the response a not found error?

from Response
bool isRedirect(string $location = null)

Is the response a redirect of some form?

from Response
bool isEmpty()

Is the response empty?

from Response
static  closeOutputBuffers(int $targetLevel, bool $flush)

Cleans or flushes output buffers up to target level.

from Response
setCallback(callable $callback)

Sets the PHP callback associated with this Response.

Details

at line 43
public __construct(callable|null $callback = null, int $status = 200, array $headers = array())

Constructor.

Parameters

callable|null $callback A valid PHP callback or null to set it later
int $status The response status code
array $headers An array of response headers

at line 62
static public StreamedResponse create(callable|null $callback = null, int $status = 200, array $headers = array())

Factory method for chainability

Parameters

callable|null $callback A valid PHP callback or null to set it later
int $status The response status code
array $headers An array of response headers

Return Value

StreamedResponse

in Response at line 240
public string __toString()

Returns the Response as an HTTP string.

The string representation of the Response is the same as the one that will be sent to the client only if the prepare() method has been called before.

Return Value

string The Response as an HTTP string

See also

prepare()

in Response at line 251
public __clone()

Clones the current Response instance.

in Response at line 267
public Response prepare(Request $request)

Prepares the Response before it is sent to the client.

This method tweaks the Response to ensure that it is compliant with RFC 2616. Most of the changes are based on the Request that is "associated" with this Response.

Parameters

Request $request A Request instance

Return Value

Response The current response.

in Response at line 329
public Response sendHeaders()

Sends HTTP headers.

Return Value

Response

at line 87
public Response sendContent()

Sends content for the current web response.

Return Value

Response

in Response at line 373
public Response send()

Sends HTTP headers and content.

Return Value

Response

at line 107
public Response setContent(mixed $content)

Sets the response content.

Valid types are strings, numbers, null, and objects that implement a __toString() method.

Parameters

mixed $content Content that can be cast to string

Return Value

Response

Exceptions

UnexpectedValueException

at line 119
public false getContent()

Gets the current response content.

Return Value

false Content

in Response at line 433
public Response setProtocolVersion(string $version)

Sets the HTTP protocol version (1.0 or 1.1).

Parameters

string $version The HTTP protocol version

Return Value

Response

in Response at line 447
public string getProtocolVersion()

Gets the HTTP protocol version.

Return Value

string The HTTP protocol version

in Response at line 467
public Response setStatusCode(int $code, mixed $text = null)

Sets the response status code.

Parameters

int $code HTTP status code
mixed $text HTTP status text If the status text is null it will be automatically populated for the known status codes and left empty otherwise.

Return Value

Response

Exceptions

InvalidArgumentException When the HTTP status code is not valid

in Response at line 498
public int getStatusCode()

Retrieves the status code for the current web response.

Return Value

int Status code

in Response at line 512
public Response setCharset(string $charset)

Sets the response charset.

Parameters

string $charset Character set

Return Value

Response

in Response at line 526
public string getCharset()

Retrieves the response charset.

Return Value

string Character set

in Response at line 544
public bool isCacheable()

Returns true if the response is worth caching under any circumstance.

Responses marked "private" with an explicit Cache-Control directive are considered uncacheable.

Responses with neither a freshness lifetime (Expires, max-age) nor cache validator (Last-Modified, ETag) are considered uncacheable.

Return Value

bool true if the response is worth caching, false otherwise

in Response at line 568
public bool isFresh()

Returns true if the response is "fresh".

Fresh responses may be served from cache without any interaction with the origin. A response is considered fresh when it includes a Cache-Control/max-age indicator or Expires header and the calculated age is less than the freshness lifetime.

Return Value

bool true if the response is fresh, false otherwise

in Response at line 581
public bool isValidateable()

Returns true if the response includes headers that can be used to validate the response with the origin server using a conditional GET request.

Return Value

bool true if the response is validateable, false otherwise

in Response at line 595
public Response setPrivate()

Marks the response as "private".

It makes the response ineligible for serving other clients.

Return Value

Response

in Response at line 612
public Response setPublic()

Marks the response as "public".

It makes the response eligible for serving other clients.

Return Value

Response

in Response at line 632
public bool mustRevalidate()

Returns true if the response must be revalidated by caches.

This method indicates that the response must not be served stale by a cache in any circumstance without first revalidating with the origin. When present, the TTL of the response should not be overridden to be greater than the value provided by the origin.

Return Value

bool true if the response must be revalidated by a cache, false otherwise

in Response at line 646
public DateTime getDate()

Returns the Date header as a DateTime instance.

Return Value

DateTime A \DateTime instance

Exceptions

RuntimeException When the header is not parseable

in Response at line 660
public Response setDate(DateTime $date)

Sets the Date header.

Parameters

DateTime $date A \DateTime instance

Return Value

Response

in Response at line 673
public int getAge()

Returns the age of the response.

Return Value

int The age of the response in seconds

in Response at line 689
public Response expire()

Marks the response stale by setting the Age header to be equal to the maximum age of the response.

Return Value

Response

in Response at line 705
public DateTime|null getExpires()

Returns the value of the Expires header as a DateTime instance.

Return Value

DateTime|null A DateTime instance or null if the header does not exist

in Response at line 726
public Response setExpires(DateTime $date = null)

Sets the Expires HTTP header with a DateTime instance.

Passing null as value will remove the header.

Parameters

DateTime $date A \DateTime instance or null to remove the header

Return Value

Response

in Response at line 750
public int|null getMaxAge()

Returns the number of seconds after the time specified in the response's Date header when the response should no longer be considered fresh.

First, it checks for a s-maxage directive, then a max-age directive, and then it falls back on an expires header. It returns null when no maximum age can be established.

Return Value

int|null Number of seconds

in Response at line 776
public Response setMaxAge(int $value)

Sets the number of seconds after which the response should no longer be considered fresh.

This methods sets the Cache-Control max-age directive.

Parameters

int $value Number of seconds

Return Value

Response

in Response at line 794
public Response setSharedMaxAge(int $value)

Sets the number of seconds after which the response should no longer be considered fresh by shared caches.

This methods sets the Cache-Control s-maxage directive.

Parameters

int $value Number of seconds

Return Value

Response

in Response at line 814
public int|null getTtl()

Returns the response's time-to-live in seconds.

It returns null when no freshness information is present in the response.

When the responses TTL is <= 0, the response may not be served from cache without first revalidating with the origin.

Return Value

int|null The TTL in seconds

in Response at line 832
public Response setTtl(int $seconds)

Sets the response's time-to-live for shared caches.

This method adjusts the Cache-Control/s-maxage directive.

Parameters

int $seconds Number of seconds

Return Value

Response

in Response at line 850
public Response setClientTtl(int $seconds)

Sets the response's time-to-live for private/client caches.

This method adjusts the Cache-Control/max-age directive.

Parameters

int $seconds Number of seconds

Return Value

Response

in Response at line 866
public DateTime|null getLastModified()

Returns the Last-Modified HTTP header as a DateTime instance.

Return Value

DateTime|null A DateTime instance or null if the header does not exist

Exceptions

RuntimeException When the HTTP header is not parseable

in Response at line 882
public Response setLastModified(DateTime $date = null)

Sets the Last-Modified HTTP header with a DateTime instance.

Passing null as value will remove the header.

Parameters

DateTime $date A \DateTime instance or null to remove the header

Return Value

Response

in Response at line 902
public string|null getEtag()

Returns the literal value of the ETag HTTP header.

Return Value

string|null The ETag HTTP header or null if it does not exist

in Response at line 917
public Response setEtag(string|null $etag = null, bool $weak = false)

Sets the ETag value.

Parameters

string|null $etag The ETag unique identifier or null to remove the header
bool $weak Whether you want a weak ETag or not

Return Value

Response

in Response at line 945
public Response setCache(array $options)

Sets the response's cache headers (validation and/or expiration).

Available options are: etag, lastmodified, maxage, s_maxage, private, and public.

Parameters

array $options An array of cache options

Return Value

Response

Exceptions

InvalidArgumentException

in Response at line 998
public Response setNotModified()

Modifies the response so that it conforms to the rules defined for a 304 status code.

This sets the status, removes the body, and discards any headers that MUST NOT be included in 304 responses.

Return Value

Response

See also

http://tools.ietf.org/html/rfc2616#section-10.3.5

in Response at line 1018
public bool hasVary()

Returns true if the response includes a Vary header.

Return Value

bool true if the response includes a Vary header, false otherwise

in Response at line 1030
public array getVary()

Returns an array of header names given in the Vary header.

Return Value

array An array of Vary names

in Response at line 1054
public Response setVary(string|array $headers, bool $replace = true)

Sets the Vary header.

Parameters

string|array $headers
bool $replace Whether to replace the actual value of not (true by default)

Return Value

Response

in Response at line 1074
public bool isNotModified(Request $request)

Determines if the Response validators (ETag, Last-Modified) match a conditional value specified in the Request.

If the Response is not modified, it sets the status code to 304 and removes the actual content by calling the setNotModified() method.

Parameters

Request $request A Request instance

Return Value

bool true if the Response validators match the Request, false otherwise

in Response at line 1107
public bool isInvalid()

Is response invalid?

Return Value

bool

in Response at line 1119
public bool isInformational()

Is response informative?

Return Value

bool

in Response at line 1131
public bool isSuccessful()

Is response successful?

Return Value

bool

in Response at line 1143
public bool isRedirection()

Is the response a redirect?

Return Value

bool

in Response at line 1155
public bool isClientError()

Is there a client error?

Return Value

bool

in Response at line 1167
public bool isServerError()

Was there a server side error?

Return Value

bool

in Response at line 1179
public bool isOk()

Is the response OK?

Return Value

bool

in Response at line 1191
public bool isForbidden()

Is the response forbidden?

Return Value

bool

in Response at line 1203
public bool isNotFound()

Is the response a not found error?

Return Value

bool

in Response at line 1217
public bool isRedirect(string $location = null)

Is the response a redirect of some form?

Parameters

string $location

Return Value

bool

in Response at line 1229
public bool isEmpty()

Is the response empty?

Return Value

bool

in Response at line 1242
static public closeOutputBuffers(int $targetLevel, bool $flush)

Cleans or flushes output buffers up to target level.

Resulting level can be greater than target level if a non-removable buffer has been encountered.

Parameters

int $targetLevel The target output buffering level
bool $flush Whether to flush or clean the buffers

at line 74
public setCallback(callable $callback)

Sets the PHP callback associated with this Response.

Parameters

callable $callback A valid PHP callback

Exceptions

LogicException