BinaryFileResponse

__construct(SplFileInfo|string $file, int $status = 200, array $headers = array(), bool $public = true, string $contentDisposition = null, bool $autoEtag = false, bool $autoLastModified = true)

Parameters

SplFileInfo|string	$file	The file to stream
int	$status
array	$headers
bool	$public	Files are public by default
string	$contentDisposition	The type of Content-Disposition to set automatically with the filename
bool	$autoEtag	Whether the ETag header should be automatically set
bool	$autoLastModified	Whether the Last-Modified header should be automatically set

static Response create(SplFileInfo|string $file = null, int $status = 200, array $headers = array(), bool $public = true, string|null $contentDisposition = null, bool $autoEtag = false, bool $autoLastModified = true)

Parameters

SplFileInfo|string	$file	The file to stream
int	$status	The response status code
array	$headers	An array of response headers
bool	$public	Files are public by default
string|null	$contentDisposition	The type of Content-Disposition to set automatically with the filename
bool	$autoEtag	Whether the ETag header should be automatically set
bool	$autoLastModified	Whether the Last-Modified header should be automatically set

Return Value

Response

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()

__clone()

Clones the current Response instance.

$this 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

Return Value

$this

$this sendHeaders()

Sends HTTP headers.

Return Value

$this

$this sendContent()

Sends the file.

{@inheritdoc}

Return Value

$this

$this send()

Sends HTTP headers and content.

Return Value

$this

$this 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

$this

Exceptions

UnexpectedValueException

string getContent()

Gets the current response content.

Return Value

string

Content

$this setProtocolVersion(string $version)

Sets the HTTP protocol version (1.0 or 1.1).

Parameters

string

$version

Return Value

$this

string getProtocolVersion()

Gets the HTTP protocol version.

Return Value

string

$this setStatusCode(int $code, $text = null)

Sets the response status code.

If the status text is null it will be automatically populated for the known status codes and left empty otherwise.

Parameters

int	$code
	$text

Return Value

$this

Exceptions

InvalidArgumentException

When the HTTP status code is not valid

int getStatusCode()

Retrieves the status code for the current web response.

Return Value

int

$this setCharset(string $charset)

Sets the response charset.

Parameters

string

$charset

Return Value

$this

string|null getCharset()

Retrieves the response charset.

Return Value

string|null

bool isCacheable()

Returns true if the response may safely be kept in a shared (surrogate) cache.

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 because there is no way to tell when or how to remove them from the cache.

Note that RFC 7231 and RFC 7234 possibly allow for a more permissive implementation, for example "status codes that are defined as cacheable by default [...] can be reused by a cache with heuristic expiration unless otherwise indicated" (https://tools.ietf.org/html/rfc7231#section-6.1)

Return Value

bool

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

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

$this setPrivate()

Marks the response as "private".

It makes the response ineligible for serving other clients.

Return Value

$this

$this setPublic()

Marks the response as "public".

It makes the response eligible for serving other clients.

Return Value

$this

$this setImmutable(bool $immutable = true)

Marks the response as "immutable".

Parameters

bool

$immutable

Return Value

$this

bool isImmutable()

Returns true if the response is marked as "immutable".

Return Value

bool

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

DateTimeInterface|null getDate()

Returns the Date header as a DateTime instance.

Return Value

DateTimeInterface|null

Exceptions

RuntimeException

When the header is not parseable

$this setDate(DateTimeInterface $date)

Sets the Date header.

Parameters

DateTimeInterface

$date

Return Value

$this

int getAge()

Returns the age of the response in seconds.

Return Value

int

$this expire()

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

Return Value

$this

DateTimeInterface|null getExpires()

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

Return Value

DateTimeInterface|null

$this setExpires(DateTimeInterface $date = null)

Sets the Expires HTTP header with a DateTime instance.

Passing null as value will remove the header.

Parameters

DateTimeInterface

$date

Return Value

$this

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

$this 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

Return Value

$this

$this 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

Return Value

$this

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

$this setTtl(int $seconds)

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

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

Parameters

int

$seconds

Return Value

$this

$this setClientTtl(int $seconds)

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

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

Parameters

int

$seconds

Return Value

$this

DateTimeInterface|null getLastModified()

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

Return Value

DateTimeInterface|null

Exceptions

RuntimeException

When the HTTP header is not parseable

$this setLastModified(DateTimeInterface $date = null)

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

Passing null as value will remove the header.

Parameters

DateTimeInterface

$date

Return Value

$this

string|null getEtag()

Returns the literal value of the ETag HTTP header.

Return Value

string|null

$this setEtag(string $etag = null, bool $weak = false)

Sets the ETag value.

Parameters

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

Return Value

$this

$this setCache(array $options)

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

Available options are: etag, last_modified, max_age, s_maxage, private, public and immutable.

Parameters

array

$options

Return Value

$this

Exceptions

InvalidArgumentException

$this 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

$this

See also

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

bool hasVary()

Returns true if the response includes a Vary header.

Return Value

bool

array getVary()

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

Return Value

array

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

Sets the Vary header.

Parameters

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

Return Value

$this

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

Return Value

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

bool isInvalid()

Is response invalid?

Return Value

bool

See also

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

bool isInformational()

Is response informative?

Return Value

bool

bool isSuccessful()

Is response successful?

Return Value

bool

bool isRedirection()

Is the response a redirect?

Return Value

bool

bool isClientError()

Is there a client error?

Return Value

bool

bool isServerError()

Was there a server side error?

Return Value

bool

bool isOk()

Is the response OK?

Return Value

bool

bool isForbidden()

Is the response forbidden?

Return Value

bool

bool isNotFound()

Is the response a not found error?

Return Value

bool

bool isRedirect(string $location = null)

Is the response a redirect of some form?

Parameters

string

$location

Return Value

bool

bool isEmpty()

Is the response empty?

Return Value

bool

static 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
bool	$flush

protected ensureIEOverSSLCompatibility(Request $request)

Checks if we need to remove Cache-Control for SSL encrypted downloads when using IE < 9.

Parameters

Request

$request

See also

http://support.microsoft.com/kb/323308

$this setFile(SplFileInfo|string $file, string $contentDisposition = null, bool $autoEtag = false, bool $autoLastModified = true)

Sets the file to stream.

Parameters

SplFileInfo|string	$file	The file to stream
string	$contentDisposition
bool	$autoEtag
bool	$autoLastModified

Return Value

$this

Exceptions

FileException

File getFile()

Gets the file.

Return Value

File	The file to stream

setAutoLastModified()

Automatically sets the Last-Modified header according the file modification date.

setAutoEtag()

Automatically sets the ETag header according to the checksum of the file.

$this setContentDisposition(string $disposition, string $filename = '', string $filenameFallback = '')

Sets the Content-Disposition header with the given filename.

Parameters

string	$disposition	ResponseHeaderBag::DISPOSITION_INLINE or ResponseHeaderBag::DISPOSITION_ATTACHMENT
string	$filename	Optionally use this UTF-8 encoded filename instead of the real name of the file
string	$filenameFallback	A fallback filename, containing only ASCII characters. Defaults to an automatically encoded filename

Return Value

$this

static trustXSendfileTypeHeader()

Trust X-Sendfile-Type header.

$this deleteFileAfterSend(bool $shouldDelete = true)

If this is set to true, the file will be unlinked after the request is send Note: If the X-Sendfile header is used, the deleteFileAfterSend setting will not be used.

Parameters

bool

$shouldDelete

Return Value

$this