Запрос

класс Запрос

Запрос представляет HTTP-запрос.

Методы, работающие с URL, принимают/возвращают сырой путь (% закодированный): * getBasePath * getBaseUrl * getPathInfo * getRequestUri * getUri * getUriForPath

Постоянные значения

HEADER_FORWARDED
HEADER_X_FORWARDED_FOR
HEADER_X_FORWARDED_HOST
HEADER_X_FORWARDED_PROTO
HEADER_X_FORWARDED_PORT
HEADER_X_FORWARDED_ALL
HEADER_X_FORWARDED_AWS_ELB
HEADER_CLIENT_IP
HEADER_CLIENT_HOST
HEADER_CLIENT_PROTO
HEADER_CLIENT_PORT
METHOD_HEAD
METHOD_GET
METHOD_POST
METHOD_PUT
METHOD_PATCH
METHOD_DELETE
METHOD_PURGE
METHOD_OPTIONS
METHOD_TRACE
METHOD_CONNECT

Свойства

ParameterBag	$attributes	Настраиваемые параметры.
ParameterBag	$request	Параметры тела запроса ($_POST).
ParameterBag	$query	Параметры строки запроса ($_GET).
ServerBag	$server	Параметры сервера и среды выполнения ($_SERVER).
FileBag	$files	Загруженные файлы ($_FILES).
ParameterBag	$cookies	Файлы cookie ($_COOKIE).
HeaderBag	$headers	Заголовки (взяты из $_SERVER).

Методы

	__construct(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string\|resource $content = null)
	initialize(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), string\|resource $content = null) Устанавливает параметры для этого запроса.
static Request	createFromGlobals() Создаёт новый запрос со значениями из суперглобальных переменных PHP.
static Request	create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null) Создаёт запрос на основе заданного URI и конфигурации.
static	setFactory(callable\|null $callable) Устанавливает вызываемую функцию, способную создать экземпляр Request.
Request	duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null) Создаёт копию запроса и переопределяет некоторые его параметры.
	__clone() Создаёт копию текущего запроса.
string	__toString() Возвращает запрос в виде строки.
	overrideGlobals() Переопределяет глобальные переменные PHP в соответствии с этим экземпляром запроса.
static	setTrustedProxies(array $proxies) Устанавливает список доверенных прокси.
static array	getTrustedProxies() Возвращает список доверенных прокси.
static int	getTrustedHeaderSet() Возвращает набор доверенных заголовков из доверенных прокси.
static	setTrustedHosts(array $hostPatterns) Устанавливает список доверенных хостов.
static array	getTrustedHosts() Возвращает список доверенных шаблонов хостов.
static	setTrustedHeaderName(string $key, string $value) ^deprecated Устанавливает имя для доверенных заголовков.
static string	getTrustedHeaderName(string $key) ^deprecated Возвращает имя заголовка доверенного прокси.
static string	normalizeQueryString(string $qs) Нормализует строку запроса.
static	enableHttpMethodParameterOverride() Включает поддержку параметра _method в запросе для определения предполагаемого HTTP-метода.
static bool	getHttpMethodParameterOverride() Проверяет, включена ли поддержка параметра _method в запросе.
mixed	get(string $key, mixed $default = null) Возвращает значение "параметра" из любого контейнера.
SessionInterface\|null	getSession() Возвращает сеанс.
bool	hasPreviousSession() Определяет, содержит ли запрос сеанс, который был начат в одном из предыдущих запросов.
bool	hasSession() Определяет, содержит ли запрос объект сеанса.
	setSession(SessionInterface $session) Устанавливает сеанс.
array	getClientIps() Возвращает адреса IP клиента.
string\|null	getClientIp() Возвращает адрес IP клиента.
string	getScriptName() Возвращает имя текущего скрипта.
string	getPathInfo() Возвращает путь, запрашиваемый относительно выполняемого скрипта.
string	getBasePath() Возвращает корневой путь, с которого выполняется этот запрос.
string	getBaseUrl() Возвращает корневой URL, с которого выполняется этот запрос.
string	getScheme() Возвращает схему запроса.
int\|string	getPort() Возвращает порт, на котором выполнен запрос.
string\|null	getUser() Возвращает пользователя.
string\|null	getPassword() Возвращает пароль.
string	getUserInfo() Возвращает информацию о пользователе.
string	getHttpHost() Возвращает запрошенный HTTP-хост.
string	getRequestUri() Возвращает запрашиваемый URI (путь и строка запроса).
string	getSchemeAndHttpHost() Возвращает схему и HTTP-хост.
string	getUri() Генерирует нормализованный URI (URL) для запроса.
string	getUriForPath(string $path) Генерирует нормализованный URI для заданного пути.
string	getRelativeUriForPath(string $path) Возвращает путь в качестве относительной ссылки от текущего пути запроса.
string\|null	getQueryString() Генерирует нормализованную строку запроса для запроса.
bool	isSecure() Проверяет, является ли запрос защищённым.
string	getHost() Возвращает имя хоста.
	setMethod(string $method) Устанавливает метод запроса.
string	getMethod() Возвращает "намеченный" метод запроса.
string	getRealMethod() Возвращает "фактический" метод запроса.
string	getMimeType(string $format) Возвращает MIME-тип, связанный с форматом.
static array	getMimeTypes(string $format) Возвращает MIME-типы, связанные с форматом.
string\|null	getFormat(string $mimeType) Возвращает формат, связанный с MIME-типом.
	setFormat(string $format, string\|array $mimeTypes) Связывает формат с MIME-типами.
string	getRequestFormat(string $default = 'html') Возвращает формат запроса.
	setRequestFormat(string $format) Устанавливает формат запроса.
string\|null	getContentType() Возвращает формат, связанный с запросом.
	setDefaultLocale(string $locale) Устанавливает значение по умолчанию для локали.
string	getDefaultLocale() Возвращает значение локали по умолчанию.
	setLocale(string $locale) Устанавливает локаль.
string	getLocale() Возвращает локаль.
bool	isMethod(string $method) Проверяет, соответствует ли метод запроса заданному типу.
bool	isMethodSafe() Проверяет, является ли метод безопасным.
bool	isMethodIdempotent() Проверяет, является ли метод идемпотентным.
bool	isMethodCacheable() Проверяет, является ли метод кешируемым.
string	getProtocolVersion() Возвращает версию протокола.
string\|resource	getContent(bool $asResource = false) Возвращает содержимое тела запроса.
array	getETags() Возвращает значения ETags.
bool	isNoCache()
string\|null	getPreferredLanguage(array $locales = null) Возвращает предпочтительный язык.
array	getLanguages() Возвращает список языков, допустимых для браузера клиента.
array	getCharsets() Возвращает список наборов символов, допустимых для браузера клиента.

массив	getEncodings() Получает список кодировок, приемлемых для браузера-клиента.
массив	getAcceptableContentTypes() Получает список типов контента, приемлемых для браузера-клиента.
bool	isXmlHttpRequest() Возвращает true, если запрос является XMLHttpRequest.
bool	isFromTrustedProxy() Указывает, был ли этот запрос получен от доверенного прокси-сервера.

Подробности

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

Параметры

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

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

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

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

Параметры

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

static Запрос createFromGlobals()

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

Значение, возвращаемое функцией

Запрос

static Запрос create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

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

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

Параметры

string	$uri	URI
string	$method	HTTP-метод
array	$parameters	Параметры запроса (GET или POST)
array	$cookies	Куки запроса ($_COOKIE)
array	$files	Файлы запроса ($_FILES)
array	$server	Параметры сервера ($_SERVER)
string	$content	Сырые данные тела запроса

Значение, возвращаемое функцией

Запрос

static setFactory(callable|null $callable)

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

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

Параметры

callable|null

$callable

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

Запрос 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

Значение, возвращаемое функцией

Запрос

__clone()

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

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

string __toString()

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

Значение, возвращаемое функцией

string

Запрос

overrideGlobals()

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

Переопределяет $GET, $POST, $REQUEST, $SERVER, $COOKIE. $FILES никогда не переопределяется, см. rfc1867

static setTrustedProxies(array $proxies)

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

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

Параметры

array

$proxies

Исключения

InvalidArgumentException

Если $trustedHeaderSet некорректен

static array getTrustedProxies()

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

Значение, возвращаемое функцией

array

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

static int getTrustedHeaderSet()

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

Значение, возвращаемое функцией

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

static setTrustedHosts(array $hostPatterns)

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

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

Параметры

array

$hostPatterns

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

static array getTrustedHosts()

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

Значение, возвращаемое функцией

array

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

static setTrustedHeaderName(string $key, string $value) ^{устарело}

^{устарело}

since версия 3.3, будет удалено в 4.0. Используйте аргумент $trustedHeaderSet метода Request::setTrustedProxies() вместо него.

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

Поддерживаются следующие ключи заголовков:

Request::HEADERCLIENTIP: по умолчанию X-Forwarded-For (см. getClientIp())
Request::HEADERCLIENTHOST: по умолчанию X-Forwarded-Host (см. getHost())
Request::HEADERCLIENTPORT: по умолчанию X-Forwarded-Port (см. getPort())
Request::HEADERCLIENTPROTO: по умолчанию X-Forwarded-Proto (см. getScheme() и isSecure())
Request::HEADER_FORWARDED: по умолчанию Forwarded (см. RFC 7239)

Установка пустого значения позволяет отключить доверенный заголовок для данного ключа.

Параметры

string	$key	Ключ заголовка
string	$value	Имя заголовка

Исключения

InvalidArgumentException

static string getTrustedHeaderName(string $key) ^{устарело}

^{устарело}

since версия 3.3, будет удалено в 4.0. Используйте метод Request::getTrustedHeaderSet() вместо него.

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

Параметры

string

$key

Ключ заголовка

Значение, возвращаемое функцией

string

Имя заголовка

Исключения

InvalidArgumentException

static string normalizeQueryString(string $qs)

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

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

Параметры

string

$qs

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

Значение, возвращаемое функцией

string

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

static enableHttpMethodParameterOverride()

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

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

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

static bool getHttpMethodParameterOverride()

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

Значение, возвращаемое функцией

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

смешанный тип get(string $key, mixed $default = null)

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

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

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

Параметры

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

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

смешанный тип

SessionInterface|null getSession()

Получает сеанс.

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

SessionInterface|null

Сеанс

bool hasPreviousSession()

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

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

bool

bool hasSession()

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

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

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

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

setSession(SessionInterface $session)

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

Параметры

SessionInterface

$session

Сеанс

array getClientIps()

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

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

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

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

array

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

См. также

getClientIp()

string|null getClientIp()

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

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

Если ваш обратный прокси-сервер использует имя заголовка, отличное от «X-Forwarded-For» (например, «Client-Ip»), настройте его через аргумент $trustedHeaderSet метода Request::setTrustedProxies() вместо этого.

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

string|null

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

См. также

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

string getScriptName()

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

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

string

string getPathInfo()

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

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

Предположим, что этот запрос создаётся из /mysite на локальном хосте:

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» должен содержать порт клиента.

Если ваш обратный прокси-сервер использует имя заголовка, отличное от «X-Forwarded-Port», настройте его через аргумент $trustedHeaderSet метода Request::setTrustedProxies() вместо этого.

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

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».

Если ваш обратный прокси-сервер использует имя заголовка, отличное от «X-Forwarded-Proto» (например, «SSL_HTTPS»), настройте его через аргумент $trustedHeaderSet метода Request::setTrustedProxies() вместо этого.

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

bool

строка getHost()

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

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

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

Если ваш обратный прокси использует имя заголовка, отличное от «X-Forwarded-Host», настройте его через аргумент $trustedHeaderSet метода Request::setTrustedProxies() вместо этого.

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

строка

Исключения

SuspiciousOperationException

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

setMethod(строка $method)

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

Параметры

строка

$method

строка getMethod()

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

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

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

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

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

строка

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

См. также

getRealMethod()

строка getRealMethod()

Получает "фактический" метод запроса.

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

строка

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

См. также

getMethod()

строка getMimeType(строка $format)

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

Параметры

строка

$format

Формат

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

строка

Соответствующий MIME-тип (null, если не найден)

статический массив getMimeTypes(строка $format)

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

Параметры

строка

$format

Формат

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

массив

Соответствующие MIME-типы

строка|null getFormat(строка $mimeType)

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

Параметры

строка

$mimeType

Соответствующий MIME-тип

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

строка|null

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

setFormat(строка $format, строка|массив $mimeTypes)

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

Параметры

строка	$format	Формат
строка\|массив	$mimeTypes	Соответствующие MIME-типы (предпочтительный должен быть первым, так как он будет использоваться в качестве типа контента)

строка getRequestFormat(строка $default = 'html')

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

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

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

Параметры

строка

$default

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

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

строка

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

setRequestFormat(строка $format)

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

Параметры

строка

$format

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

строка|null getContentType()

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

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

строка|null

Формат (null, если тип контента отсутствует)

setDefaultLocale(строка $locale)

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

Параметры

строка

$locale

строка getDefaultLocale()

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

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

строка

setLocale(строка $locale)

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

Параметры

строка

$locale

строка getLocale()

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

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

строка

логическое isMethod(строка $method)

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

Параметры

строка

$method

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

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

логическое

логическое isMethodSafe()

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

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

логическое

См. также

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

логическое isMethodIdempotent()

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

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

логическое

логическое isMethodCacheable()

Проверяет, может ли метод кешироваться.

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

логическое

См. также

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

строка getProtocolVersion()

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

Если приложение находится за прокси-сервером, версия протокола, используемая в запросах между клиентом и прокси-сервером и между прокси-сервером и сервером, может отличаться. Эта функция возвращает первую (из заголовка "Via"), если прокси доверен, в противном случае возвращает вторую (из параметра сервера "SERVER_PROTOCOL").

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

строка

строка|ресурс getContent(логическое $asResource = ложь)

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

Параметры

логическое

$asResource

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

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

строка|ресурс

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

Исключения

LogicException

массив getETags()

Получает ETags.

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

массив

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

логическое isNoCache()

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

логическое

строка|null getPreferredLanguage(массив $locales = null)

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

Параметры

массив

$locales

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

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

строка|null

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

массив getLanguages()

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

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

массив

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

массив getCharsets()

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

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

массив

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

массив getEncodings()

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

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

массив

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

массив getAcceptableContentTypes()

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

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

массив

Список типов контента в предпочтительном порядке

логическое isXmlHttpRequest()

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

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

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

логическое

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

См. также

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

логическое isFromTrustedProxy()

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

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

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

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

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

Запрос

Постоянные значения

Свойства

Методы

Подробности

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

Параметры

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

Параметры

static Запрос createFromGlobals()

Значение, возвращаемое функцией

static Запрос create(string $uri, string $method = 'GET', array $parameters = array(), array $cookies = array(), array $files = array(), array $server = array(), string $content = null)

Параметры

Значение, возвращаемое функцией

static setFactory(callable|null $callable)

Параметры

Запрос duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)

Параметры

Значение, возвращаемое функцией

__clone()

string __toString()

Значение, возвращаемое функцией

overrideGlobals()

static setTrustedProxies(array $proxies)

Параметры

Исключения

static array getTrustedProxies()

Значение, возвращаемое функцией

static int getTrustedHeaderSet()

Значение, возвращаемое функцией

static setTrustedHosts(array $hostPatterns)

Параметры

static array getTrustedHosts()

Значение, возвращаемое функцией

static setTrustedHeaderName(string $key, string $value) устарело

Параметры

Исключения

static string getTrustedHeaderName(string $key) устарело

Параметры

Значение, возвращаемое функцией

Исключения

static string normalizeQueryString(string $qs)

Параметры

Значение, возвращаемое функцией

static enableHttpMethodParameterOverride()

static bool getHttpMethodParameterOverride()

Значение, возвращаемое функцией

смешанный тип get(string $key, mixed $default = null)

Параметры

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

SessionInterface|null getSession()

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

bool hasPreviousSession()

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

bool hasSession()

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

setSession(SessionInterface $session)

Параметры

array getClientIps()

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

См. также

string|null getClientIp()

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

См. также

string getScriptName()

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

string getPathInfo()

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

string getBasePath()

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

string getBaseUrl()

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

string getScheme()

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

int|string getPort()

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

string|null getUser()

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

string|null getPassword()

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

static setTrustedHeaderName(string $key, string $value) ^{устарело}

static string getTrustedHeaderName(string $key) ^{устарело}