Spec-Zone.ru › Symfony 4.1

HeaderUtils

class HeaderUtils

Функции для работы с HTTP-заголовками.

Методы

static array split(string $header, string $separators)

Разделяет HTTP-заголовок по одному или нескольким разделителям.

static array combine(array $parts)

Объединяет массив массивов в один ассоциативный массив.

static string toString(array $assoc, string $separator)

Преобразует ассоциативный массив в строку для использования в HTTP-заголовке.

static string quote(string $s)

Кодирует строку как строку в кавычках, если необходимо.

static string unquote(string $s)

Декодирует строку в кавычках.

Подробности

static array split(string $header, string $separators)

Разделяет HTTP-заголовок по одному или нескольким разделителям.

Пример:

HeaderUtils::split("da, en-gb;q=0.8", ",;")
// => array(array('da'), array('en-gb', 'q=0.8'))

Параметры

string $header Значение HTTP-заголовка
string $separators Список символов для разделения, упорядоченных по приоритету, например ",", ";=", или ",;="

Возвращаемое значение

array Вложенный массив с количеством уровней, равным количеству символов в $separators

static array combine(array $parts)

Объединяет массив массивов в один ассоциативный массив.

Каждый из вложенных массивов должен иметь один или два элемента. Первое значение будет использовано в качестве ключей в ассоциативном массиве, а второе - в качестве значений, или true, если вложенный массив содержит только один элемент. Ключи массивов приводятся к нижнему регистру.

Пример:

HeaderUtils::combine(array(array("foo", "abc"), array("bar")))
// => array("foo" => "abc", "bar" => true)

Параметры

array $parts

Возвращаемое значение

array

static string toString(array $assoc, string $separator)

Преобразует ассоциативный массив в строку для использования в HTTP-заголовке.

Ключ и значение каждого элемента объединяются символом "=", а все элементы объединяются указанным разделителем и дополнительным пробелом (для удобочитаемости). Значения приводятся в кавычки при необходимости.

Пример:

HeaderUtils::toString(array("foo" => "abc", "bar" => true, "baz" => "a b c"), ",")
// => 'foo=abc, bar, baz="a b c"'

Параметры

array $assoc
string $separator

Возвращаемое значение

string

static string quote(string $s)

Кодирует строку как строку в кавычках, если необходимо.

Если строка содержит символы, не разрешенные конструкцией "token" в спецификации HTTP, она экранируется обратной косой чертой и заключается в кавычки для соответствия конструкции "quoted-string".

Параметры

string $s

Возвращаемое значение

string

static string unquote(string $s)

Декодирует строку в кавычках.

Если передана строка без кавычек, которая соответствует конструкции "token" (как определено в спецификации HTTP), она передается без изменений.

Параметры

string $s

Возвращаемое значение

string

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/HttpFoundation/HeaderUtils.html

Spec-Zone.ru

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