ResponseHeaderBag

__construct(array $headers = array())

Параметры

array

$headers

Массив HTTP-заголовков

string __toString()

Возвращает заголовки в виде строки.

Значение, возвращаемое функцией

string

Заголовки

array all()

Возвращает заголовки.

Значение, возвращаемое функцией

array

Массив заголовков

array keys()

Возвращает ключи параметров.

Значение, возвращаемое функцией

array

Массив ключей параметров

replace(array $headers = array())

Заменяет текущие HTTP-заголовки новым набором.

Параметры

array

$headers

Массив HTTP-заголовков

add(array $headers)

Добавляет новые заголовки к текущему набору HTTP-заголовков.

Параметры

array

$headers

Массив HTTP-заголовков

string|string[]|null get(string $key, string|string[]|null $default = null, bool $first = true)

Возвращает значение заголовка по имени.

Параметры

string	$key	Имя заголовка
string|string[]|null	$default	Значение по умолчанию
bool	$first	Возвращать первое значение или все значения заголовков

Значение, возвращаемое функцией

string|string[]|null

Первое значение заголовка или значение по умолчанию, если $first имеет значение true; массив значений в противном случае

set(string $key, string|string[] $values, bool $replace = true)

Устанавливает заголовок по имени.

Параметры

string	$key	Ключ
string|string[]	$values	Значение или массив значений
bool	$replace	Заменять фактическое значение или нет (по умолчанию true)

bool has(string $key)

Возвращает true, если HTTP-заголовок определён.

Параметры

string

$key

HTTP-заголовок

Значение, возвращаемое функцией

bool	true, если параметр существует, иначе false

bool contains(string $key, string $value)

Возвращает true, если данный HTTP-заголовок содержит данное значение.

Параметры

string	$key	Имя HTTP-заголовка
string	$value	HTTP-значение

Значение, возвращаемое функцией

bool	true, если значение содержится в заголовке, иначе false

remove(string $key)

Удаляет заголовок.

Параметры

string

$key

Имя HTTP-заголовка

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

Возвращает значение HTTP-заголовка, преобразованное в дату.

Параметры

string	$key	Ключ параметра
DateTime	$default	Значение по умолчанию

Значение, возвращаемое функцией

DateTime|null

Парсированный DateTime или значение по умолчанию, если заголовок не существует

Исключения

RuntimeException

При невозможности парсинга HTTP-заголовка

addCacheControlDirective(string $key, mixed $value = true)

Добавляет пользовательскую директиву Cache-Control.

Параметры

string	$key	Имя директивы Cache-Control
mixed	$value	Значение директивы Cache-Control

bool hasCacheControlDirective(string $key)

Возвращает true, если директива Cache-Control определена.

Параметры

string

$key

Директива Cache-Control

Значение, возвращаемое функцией

bool	true, если директива существует, иначе false

mixed|null getCacheControlDirective(string $key)

Возвращает значение директивы Cache-Control по имени.

Параметры

string

$key

Имя директивы

Значение, возвращаемое функцией

mixed|null

Значение директивы, если определено, иначе null

removeCacheControlDirective(string $key)

Удаляет директиву Cache-Control.

Параметры

string

$key

Директива Cache-Control

ArrayIterator getIterator()

Возвращает итератор для заголовков.

Значение, возвращаемое функцией

ArrayIterator

Экземпляр \ArrayIterator

int count()

Возвращает количество заголовков.

Значение, возвращаемое функцией

int	Количество заголовков

protected getCacheControlHeader()

protected array parseCacheControl(string $header)

Парсит HTTP-заголовок Cache-Control.

Параметры

string

$header

Значение HTTP-заголовка Cache-Control

Значение, возвращаемое функцией

array

Массив, представляющий значения атрибутов

array allPreserveCase()

Возвращает заголовки с исходным регистром.

Значение, возвращаемое функцией

array

Массив заголовков

allPreserveCaseWithoutCookies()

setCookie(Cookie $cookie)

Параметры

Cookie

$cookie

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

Удаляет cookie из массива, но не удаляет его в браузере.

Параметры

string	$name
string	$path
string	$domain

Cookie[] getCookies(string $format = self::COOKIES_FLAT)

Возвращает массив со всеми cookie.

Параметры

string

$format

Значение, возвращаемое функцией

Cookie[]

Исключения

InvalidArgumentException

При некорректном $format

clearCookie(string $name, string $path = '/', string $domain = null, bool $secure = false, bool $httpOnly = true)

Очищает cookie в браузере.

Параметры

string	$name
string	$path
string	$domain
bool	$secure
bool	$httpOnly

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

Генерирует значение HTTP-поля Content-Disposition.

Параметры

string	$disposition	"inline" или "attachment"
string	$filename	Строка Юникода
string	$filenameFallback	Строка, содержащая только символы ASCII, семантически эквивалентная $filename. Если $filename уже ASCII, можно опустить или скопировать из $filename

Значение, возвращаемое функцией

string

Строка, подходящая для использования в качестве значения поля Content-Disposition

Исключения

InvalidArgumentException

См. также

RFC

6266

protected string computeCacheControlValue()

Возвращает вычисленное значение заголовка cache-control.

Это учитывает несколько других заголовков и вычисляет или изменяет заголовок cache-control на разумное, консервативное значение.

Значение, возвращаемое функцией

string