Spec-Zone.ru › Symfony 2.8

HeaderBag

class HeaderBag implements IteratorAggregate, Countable

HeaderBag — это контейнер для HTTP-заголовков.

Методы

__construct(array $headers = array())
string __toString()

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

array all()

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

array keys()

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

replace(array $headers = array())

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

add(array $headers)

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

string|array get(string $key, mixed $default = null, bool $first = true)

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

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

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

bool has(string $key)

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

bool contains(string $key, string $value)

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

remove(string $key)

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

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

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

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

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

bool hasCacheControlDirective(string $key)

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

mixed|null getCacheControlDirective(string $key)

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

removeCacheControlDirective(string $key)

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

ArrayIterator getIterator()

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

int count()

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

Подробности

__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|array get(string $key, mixed $default = null, bool $first = true)

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

Параметры

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

Значение результата

string|array Первое значение заголовка, если $first — true, в противном случае массив значений

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

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

Параметры

string $key Ключ
string|array $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-заголовка

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

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

Параметры

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

Значение результата

null|DateTime Разбор 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 Количество заголовков

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/HttpFoundation/HeaderBag.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API