Запрос

__construct(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string|resource|null $content = null)

Параметры

array	$query	Параметры GET
array	$request	Параметры POST
array	$attributes	Атрибуты запроса (параметры, извлеченные из PATH_INFO и т. д.)
array	$cookies	Параметры COOKIE
array	$files	Параметры FILES
array	$server	Параметры SERVER
string|resource|null	$content	Необработанные данные тела

initialize(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string|resource|null $content = null)

Устанавливает параметры для этого запроса.

Этот метод также повторно инициализирует все свойства.

Параметры

array	$query	Параметры GET
array	$request	Параметры POST
array	$attributes	Атрибуты запроса (параметры, извлеченные из PATH_INFO и т. д.)
array	$cookies	Параметры COOKIE
array	$files	Параметры FILES
array	$server	Параметры SERVER
string|resource|null	$content	Необработанные данные тела

static Request createFromGlobals()

Создает новый запрос с значениями из глобальных переменных PHP.

Значение возврата

Request

static Request create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string|resource|null $content = null)

Создает запрос на основе заданного URI и конфигурации.

Информация, содержащаяся в URI, всегда имеет приоритет над другой информацией (сервер и параметры).

Параметры

string	$uri	URI
string	$method	Метод HTTP
array	$parameters	Параметры запроса (GET или POST)
array	$cookies	Cookies запроса ($_COOKIE)
array	$files	Файлы запроса ($_FILES)
array	$server	Параметры сервера ($_SERVER)
string|resource|null	$content	Необработанные данные тела

Значение возврата

Request

static setFactory(callable|null $callable)

Устанавливает вызываемый объект, способный создавать экземпляр Request.

Это в основном полезно, когда необходимо переопределить класс Request для сохранения обратной совместимости с существующей системой. Не следует использовать для других целей.

Параметры

callable|null

$callable

Вызываемый объект PHP

Request duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

Создает копию запроса и переопределяет некоторые его параметры.

Параметры

array	$query	Параметры GET
array	$request	Параметры POST
array	$attributes	Атрибуты запроса (параметры, извлеченные из PATH_INFO и т. д.)
array	$cookies	Параметры COOKIE
array	$files	Параметры FILES
array	$server	Параметры SERVER

Значение возврата

Request

__clone()

Создает копию текущего запроса.

Обратите внимание, что сессия не клонируется, так как дублированные запросы чаще всего являются подзапросами основного запроса.

string __toString()

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

Значение возврата

string

Запрос

overrideGlobals()

Переопределяет глобальные переменные PHP в соответствии с этим экземпляром запроса.

Переопределяются $_GET, $_POST, $_REQUEST, $_SERVER, $_COOKIE. $_FILES никогда не переопределяется, см. rfc1867

static setTrustedProxies(array $proxies, int $trustedHeaderSet)

Устанавливает список доверенных прокси-серверов.

В списке должны быть только те обратные прокси-серверы, которые вы управляете напрямую.

Параметры

array	$proxies	Список доверенных прокси-серверов
int	$trustedHeaderSet	Поле битов Request::HEADER_*, определяющее, какие заголовки нужно доверять от ваших прокси-серверов

Исключения

InvalidArgumentException

Если $trustedHeaderSet имеет недопустимое значение

static array getTrustedProxies()

Возвращает список доверенных прокси-серверов.

Значение возврата

array

Массив доверенных прокси-серверов

static int getTrustedHeaderSet()

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

Значение возврата

int	Поле битов Request::HEADER_*, определяющее, какие заголовки доверены от ваших прокси-серверов

static setTrustedHosts(array $hostPatterns)

Устанавливает список доверенных хостов.

В списке должны быть только те хосты, которые вы управляете, используя регулярные выражения.

Параметры

array

$hostPatterns

Список доверенных шаблонов хостов

static array getTrustedHosts()

Возвращает список доверенных шаблонов хостов.

Значение возврата

array

Массив доверенных шаблонов хостов

static string normalizeQueryString(string $qs)

Нормализует строку запроса.

Строит нормализованную строку запроса, где пары ключ/значение отсортированы по алфавиту, имеют согласованное экранирование и удаляются ненужные разделители.

Параметры

string

$qs

Строка запроса

Значение возврата

string

Нормализованная строка запроса для Request

static enableHttpMethodParameterOverride()

Включает поддержку параметра запроса _method для определения предполагаемого метода HTTP.

Будьте осторожны, включение этой функции может привести к проблемам с CSRF в вашем коде. Убедитесь, что вы используете токены CSRF, когда это необходимо. Если переопределение метода HTTP включено, форму html с методом "POST" можно изменить и использовать для отправки запроса "PUT" или "DELETE" с помощью параметра запроса _method. Если эти методы не защищены от CSRF, это представляет собой потенциальную уязвимость.

Метод HTTP может быть переопределен только тогда, когда реальный метод HTTP — POST.

static bool getHttpMethodParameterOverride()

Проверяет, включена ли поддержка параметра запроса _method.

Значение возврата

bool	True, если параметр запроса _method включен, false в противном случае

mixed get(string $key, mixed $default = null)

Получает значение "параметра" из любого набора.

Этот метод в основном полезен для библиотек, которые хотят предоставить некоторую гибкость. Если вам не нужна гибкость в контроллерах, лучше явно получить параметры запроса из соответствующего публичного свойства вместо этого (атрибуты, параметры запроса GET, параметры тела).

Порядок приоритета: PATH (маркеры маршрутизации или пользовательские атрибуты), GET, BODY

Параметры

string	$key	Ключ
mixed	$default	Значение по умолчанию, если параметр с указанным ключом не существует

Значение возврата

mixed

SessionInterface|null getSession()

Получает сессию.

Значение возврата

SessionInterface|null

Сессия

bool hasPreviousSession()

Указывает, содержит ли запрос сессию, начатую в одном из предыдущих запросов.

Значение возврата

bool

bool hasSession()

Указывает, содержит ли запрос объект сессии.

Этот метод не предоставляет никакой информации о состоянии объекта сессии, например, о том, начата ли сессия. Это просто способ проверить, связан ли этот запрос с экземпляром Session.

Значение возврата

bool	true, если запрос содержит объект Session, false в противном случае

setSession(SessionInterface $session)

Устанавливает сеанс.

Параметры

SessionInterface

$session

Сеанс

setSessionFactory(callable $factory)

Параметры

callable

$factory

array getClientIps()

Возвращает адреса IP-клиента.

В возвращаемом массиве адрес IP с наибольшим уровнем доверия находится в начале, а с наименьшим — в конце. «Реальный» адрес IP-клиента — это последний элемент, но он и наименее надёжен. Доверенные прокси-серверы удаляются.

Используйте этот метод с осторожностью; вместо него следует использовать getClientIp().

Значение возврата

array

Адреса IP-клиента

См. также

getClientIp()

string|null getClientIp()

Возвращает адрес IP-клиента.

Этот метод может считывать адрес IP-клиента из заголовка «X-Forwarded-For», если доверенные прокси-серверы были заданы с помощью «setTrustedProxies()». Значение заголовка «X-Forwarded-For» представляет собой список адресов IP, разделённых запятой и пробелом; самый левый адрес — это исходный клиент, а каждый последующий прокси-сервер, передающий запрос, добавляет адрес IP, с которого он получил запрос.

Значение возврата

string|null

Адрес IP-клиента

См. также

getClientIps()
http://en.wikipedia.org/wiki/X-Forwarded-For

string getScriptName()

Возвращает имя текущего скрипта.

Значение возврата

string

string getPathInfo()

Возвращает путь, запрашиваемый относительно исполняемого скрипта.

Путь всегда начинается с /.

Предположим, этот запрос создан из /mysite на localhost:

• http://localhost/mysite возвращает пустую строку
• http://localhost/mysite/about возвращает '/about'
• http://localhost/mysite/enco%20ded возвращает '/enco%20ded'
• http://localhost/mysite/about?var=1 возвращает '/about'

Значение возврата

string

Исходный путь (т.е. не декодированный с помощью URL)

string getBasePath()

Возвращает корневой путь, с которого выполняется этот запрос.

Предположим, что файл index.php создаёт этот объект запроса:

• http://localhost/index.php возвращает пустую строку
• http://localhost/index.php/page возвращает пустую строку
• http://localhost/web/index.php возвращает '/web'
• http://localhost/we%20b/index.php возвращает '/we%20b'

Значение возврата

string

Исходный путь (т.е. не декодированный с помощью URL)

string getBaseUrl()

Возвращает корневой URL, с которого выполняется этот запрос.

Корневой URL никогда не заканчивается на /.

Это аналогично getBasePath(), за исключением того, что он также включает имя файла скрипта (например, index.php), если оно существует.

Значение возврата

string

Исходный URL (т.е. не декодированный с помощью URL)

string getScheme()

Получает схему запроса.

Значение возврата

string

int|string getPort()

Возвращает порт, на котором сделан запрос.

Этот метод может считывать порт клиента из заголовка «X-Forwarded-Port», если доверенные прокси-серверы были заданы с помощью «setTrustedProxies()».

Заголовок «X-Forwarded-Port» должен содержать порт клиента.

Значение возврата

int|string

может быть строкой, если извлечено из пакета сервера

string|null getUser()

Возвращает пользователя.

Значение возврата

string|null

string|null getPassword()

Возвращает пароль.

Значение возврата

string|null

string getUserInfo()

Получает информацию о пользователе.

Значение возврата

string

Имя пользователя и, необязательно, информация о схеме, необходимая для авторизации доступа к серверу

string getHttpHost()

Возвращает запрашиваемый HTTP-хост.

Имя порта будет добавлено к хосту, если оно нестандартное.

Значение возврата

string

string getRequestUri()

Возвращает запрашиваемый URI (путь и строка запроса).

Значение возврата

string

Исходный URI (т.е. не декодированный с помощью URI)

string getSchemeAndHttpHost()

Получает схему и HTTP-хост.

Если URL был вызван с базовой аутентификацией, имя пользователя и пароль не добавляются в сгенерированную строку.

Значение возврата

string

Схема и HTTP-хост

string getUri()

Генерирует нормализованный URI (URL) для запроса.

Значение возврата

string

Нормализованный URI (URL) для запроса

См. также

getQueryString()

string getUriForPath(string $path)

Генерирует нормализованный URI для данного пути.

Параметры

string

$path

Путь для использования вместо текущего

Значение возврата

string

Нормализованный URI для пути

string getRelativeUriForPath(string $path)

Возвращает путь в качестве относительной ссылки от текущего пути запроса.

Только компонент пути URI (без схемы, хоста и т. д.) имеет значение и должен быть указан. Оба пути должны быть абсолютными и не должны содержать относительных частей. Относительные URL-адреса от одного ресурса к другому полезны при создании автономных архивов загружаемых документов. Кроме того, они могут использоваться для уменьшения размера ссылок в документах.

Примеры целевых путей, учитывая базовый путь "/a/b/c/d": - "/a/b/c/d" -> "" - "/a/b/c/" -> "./" - "/a/b/" -> "../" - "/a/b/c/other" -> "other" - "/a/x/y" -> "../../x/y"

Параметры

string

$path

Целевой путь

Значение возврата

string

Относительный целевой путь

string|null getQueryString()

Генерирует нормализованную строку запроса для запроса.

Создаёт нормализованную строку запроса, где пары ключ/значение отсортированы по алфавиту и имеют согласованное экранирование.

Значение возврата

string|null

Нормализованная строка запроса для запроса

bool isSecure()

Проверяет, является ли запрос безопасным или нет.

Этот метод может считывать протокол клиента из заголовка «X-Forwarded-Proto», если доверенные прокси-серверы были заданы с помощью «setTrustedProxies()».

Заголовок «X-Forwarded-Proto» должен содержать протокол: «https» или «http».

Значение возврата

bool

string getHost()

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

Этот метод может считывать имя хоста клиента из заголовка «X-Forwarded-Host», если доверенные прокси-серверы были заданы с помощью «setTrustedProxies()».

Заголовок «X-Forwarded-Host» должен содержать имя хоста клиента.

Значение возврата

string

Исключения

SuspiciousOperationException

при недопустимом или недоверенном имени хоста

setMethod(string $method)

Устанавливает метод запроса.

Параметры

string

$method

string getMethod()

Получает «намеченный» метод запроса.

Если установлен заголовок X-HTTP-Method-Override, и если метод является POST, то он используется для определения «действительного» намеченного HTTP-метода.

Параметр запроса _method также можно использовать для определения HTTP-метода, но только если был вызван enableHttpMethodParameterOverride().

Метод всегда является строкой в верхнем регистре.

Значение возврата

string

Метод запроса

См. также

getRealMethod()

string getRealMethod()

Получает «действительный» метод запроса.

Значение возврата

string

Метод запроса

См. также

getMethod()

string|null getMimeType(string $format)

Получает тип MIME, связанный с форматом.

Параметры

string

$format

Формат

Значение возврата

string|null

Ассоциированный тип MIME (null, если не найден)

static array getMimeTypes(string $format)

Получает типы MIME, связанные с форматом.

Параметры

string

$format

Формат

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

array

Ассоциированные типы MIME

string|null getFormat(string $mimeType)

Получает формат, связанный с типом MIME.

Параметры

string

$mimeType

Ассоциированный тип MIME

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

string|null

Формат (null, если не найден)

setFormat(string $format, string|array $mimeTypes)

Связывает формат с типами MIME.

Параметры

string	$format	Формат
string|array	$mimeTypes	Ассоциированные типы MIME (предпочтительный тип должен быть первым, так как он будет использован как тип содержимого)

string getRequestFormat(string|null $default = 'html')

Получает формат запроса.

Вот процесс определения формата:

• формат, определенный пользователем (с помощью setRequestFormat())
• атрибут запроса _format
• $default

Параметры

string|null

$default

Формат по умолчанию

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

string

Формат запроса

setRequestFormat(string $format)

Устанавливает формат запроса.

Параметры

string

$format

Формат запроса

string|null getContentType()

Получает формат, связанный с запросом.

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

string|null

Формат (null, если тип содержимого отсутствует)

setDefaultLocale(string $locale)

Устанавливает локаль по умолчанию.

Параметры

string

$locale

string getDefaultLocale()

Получает локаль по умолчанию.

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

string

setLocale(string $locale)

Устанавливает локаль.

Параметры

string

$locale

string getLocale()

Получает локаль.

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

string

bool isMethod(string $method)

Проверяет, является ли метод запроса указанного типа.

Параметры

string

$method

Метод запроса в верхнем регистре (GET, POST и т. д.)

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

bool

bool isMethodSafe()

Проверяет, является ли метод безопасным.

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

bool

См. также

https://tools.ietf.org/html/rfc7231#section-4.2.1

bool isMethodIdempotent()

Проверяет, является ли метод идемпотентным.

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

bool

bool isMethodCacheable()

Проверяет, может ли метод быть кэширован.

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

bool

См. также

https://tools.ietf.org/html/rfc7231#section-4.2.3

string getProtocolVersion()

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

Если приложение находится за прокси-сервером, версия протокола, используемая в запросах между клиентом и прокси-сервером, а также между прокси-сервером и сервером, может отличаться. Если прокси-сервер доверенный (см. «setTrustedProxies()»), возвращается предыдущая версия (из заголовка «Via»), в противном случае возвращается последняя (из параметра сервера «SERVER_PROTOCOL»).

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

string

string|resource getContent(bool $asResource = false)

Возвращает содержимое тела запроса.

Параметры

bool

$asResource

Если true, будет возвращён ресурс

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

string|resource

Содержимое тела запроса или ресурс для чтения потока тела

Исключения

LogicException

array getETags()

Получает ETags.

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

array

Теги сущности

bool isNoCache()

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

bool

string|null getPreferredLanguage(array $locales = null)

Возвращает предпочтительный язык.

Параметры

array

$locales

Массив доступных локалей в порядке приоритета

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

string|null

Предпочтительная локаль

array getLanguages()

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

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

array

Языки в порядке предпочтений пользователя браузера

array getCharsets()

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

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

array

Список кодировок в порядке предпочтения

array getEncodings()

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

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

array

Список кодировок в порядке предпочтения

array getAcceptableContentTypes()

Получает список типов содержимого, приемлемых для браузера клиента.

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

array

Список типов содержимого в порядке предпочтения

bool isXmlHttpRequest()

Возвращает true, если запрос является XMLHttpRequest.

Работает, если ваша JavaScript библиотека устанавливает заголовок HTTP X-Requested-With. Известно, что работает с распространёнными JavaScript фреймворками:

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

bool	true, если запрос является XMLHttpRequest, иначе false

См. также

http://en.wikipedia.org/wiki/List_of_Ajax_frameworks#JavaScript

protected prepareRequestUri()

protected string prepareBaseUrl()

Подготавливает базовый URL.

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

string

protected string prepareBasePath()

Подготавливает базовый путь.

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

string

базовый путь

protected string preparePathInfo()

Подготавливает информацию о пути.

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

string

информация о пути

static protected initializeFormats()

Инициализирует форматы HTTP-запросов.

bool isFromTrustedProxy()

Указывает, исходил ли запрос от доверенного прокси-сервера.

Это может быть полезно для определения того, следует ли доверять содержимому заголовка, специфичному для прокси-сервера.

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

bool	true, если запрос пришёл от доверенного прокси-сервера, иначе false