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