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