Class

Symfony\Component\HttpFoundation\ResponseHeaderBag

class ResponseHeaderBag extends HeaderBag

ResponseHeaderBag is a container for Response HTTP headers.

Constants

COOKIES_FLAT

COOKIES_ARRAY

DISPOSITION_ATTACHMENT

DISPOSITION_INLINE

Methods

__construct(array $headers = array())

Constructor.

string __toString()

Returns the headers as a string.

array all()

Returns the headers.

from HeaderBag
array keys()

Returns the parameter keys.

from HeaderBag
replace(array $headers = array())

Replaces the current HTTP headers by a new set.

add(array $headers)

Adds new headers the current HTTP headers set.

from HeaderBag
string|array get(string $key, mixed $default = null, Boolean $first = true)

Returns a header value by name.

from HeaderBag
set(string $key, string|array $values, Boolean $replace = true)

Sets a header by name.

Boolean has(string $key)

Returns true if the HTTP header is defined.

from HeaderBag
Boolean contains(string $key, string $value)

Returns true if the given HTTP header contains the given value.

from HeaderBag
remove(string $key)

Removes a header.

null|DateTime getDate(string $key, DateTime $default = null)

Returns the HTTP header value converted to a date.

from HeaderBag
addCacheControlDirective($key, $value = true)

from HeaderBag
hasCacheControlDirective($key)

getCacheControlDirective($key)

removeCacheControlDirective($key)

from HeaderBag
ArrayIterator getIterator()

Returns an iterator for headers.

from HeaderBag
int count()

Returns the number of headers.

from HeaderBag
array allPreserveCase()

Returns the headers, with original capitalizations.

setCookie(Cookie $cookie)

Sets a cookie.

removeCookie(string $name, string $path = '/', string $domain = null)

Removes a cookie from the array, but does not unset it in the browser

array getCookies(string $format = self::COOKIES_FLAT)

Returns an array with all cookies

clearCookie(string $name, string $path = '/', string $domain = null)

Clears a cookie in the browser

string makeDisposition(string $disposition, string $filename, string $filenameFallback = '')

Generates a HTTP Content-Disposition field-value.

Details

at line 51
public __construct(array $headers = array())

Constructor.

Parameters

array $headers An array of HTTP headers

at line 63
public string __toString()

Returns the headers as a string.

Return Value

string The headers

in HeaderBag at line 73
public array all()

Returns the headers.

Return Value

array An array of headers

in HeaderBag at line 85
public array keys()

Returns the parameter keys.

Return Value

array An array of parameter keys

at line 90
public replace(array $headers = array())

Replaces the current HTTP headers by a new set.

Parameters

array $headers An array of HTTP headers

in HeaderBag at line 110
public add(array $headers)

Adds new headers the current HTTP headers set.

Parameters

array $headers An array of HTTP headers

in HeaderBag at line 128
public string|array get(string $key, mixed $default = null, Boolean $first = true)

Returns a header value by name.

Parameters

string $key The header name
mixed $default The default value
Boolean $first Whether to return the first value or all header values

Return Value

string|array The first header value if $first is true, an array of values otherwise

at line 106
public set(string $key, string|array $values, Boolean $replace = true)

Sets a header by name.

Parameters

string $key The key
string|array $values The value or an array of values
Boolean $replace Whether to replace the actual value or not (true by default)

in HeaderBag at line 182
public Boolean has(string $key)

Returns true if the HTTP header is defined.

Parameters

string $key The HTTP header

Return Value

Boolean true if the parameter exists, false otherwise

in HeaderBag at line 197
public Boolean contains(string $key, string $value)

Returns true if the given HTTP header contains the given value.

Parameters

string $key The HTTP header name
string $value The HTTP value

Return Value

Boolean true if the value is contained in the header, false otherwise

at line 127
public remove(string $key)

Removes a header.

Parameters

string $key The HTTP header name

in HeaderBag at line 232
public null|DateTime getDate(string $key, DateTime $default = null)

Returns the HTTP header value converted to a date.

Parameters

string $key The parameter key
DateTime $default The default value

Return Value

null|DateTime The parsed DateTime or the default value if the header does not exist

Exceptions

RuntimeException When the HTTP header is not parseable

in HeaderBag at line 245
public addCacheControlDirective($key, $value = true)

Parameters

$key
$value

at line 142
public hasCacheControlDirective($key)

Parameters

$key

at line 150
public getCacheControlDirective($key)

Parameters

$key

in HeaderBag at line 262
public removeCacheControlDirective($key)

Parameters

$key

in HeaderBag at line 274
public ArrayIterator getIterator()

Returns an iterator for headers.

Return Value

ArrayIterator An \ArrayIterator instance

in HeaderBag at line 284
public int count()

Returns the number of headers.

Return Value

int The number of headers

at line 80
public array allPreserveCase()

Returns the headers, with original capitalizations.

Return Value

array An array of headers

at line 162
public setCookie(Cookie $cookie)

Sets a cookie.

Parameters

Cookie $cookie

at line 176
public removeCookie(string $name, string $path = '/', string $domain = null)

Removes a cookie from the array, but does not unset it in the browser

Parameters

string $name
string $path
string $domain

at line 204
public array getCookies(string $format = self::COOKIES_FLAT)

Returns an array with all cookies

Parameters

string $format

Return Value

array

Exceptions

InvalidArgumentException When the $format is invalid

at line 235
public clearCookie(string $name, string $path = '/', string $domain = null)

Clears a cookie in the browser

Parameters

string $name
string $path
string $domain

at line 254
public string makeDisposition(string $disposition, string $filename, string $filenameFallback = '')

Generates a HTTP Content-Disposition field-value.

Parameters

string $disposition One of "inline" or "attachment"
string $filename A unicode string
string $filenameFallback A string containing only ASCII characters that is semantically equivalent to $filename. If the filename is already ASCII, it can be omitted, or just copied from $filename

Return Value

string A string suitable for use as a Content-Disposition field-value.

Exceptions

InvalidArgumentException

See also

RFC 6266