Spec-Zone.ru › Yii 2.0

Класс yii\web\Request

Все классы | Свойства | Методы | Константы
Наследование yii\web\Request » yii\base\Request » yii\base\Component » yii\base\Object
Реализует yii\base\Configurable
Доступно с версии 2.0
Исходный код https://github.com/yiisoft/yii2/blob/master/framework/web/Request.php

Класс веб-запроса Request представляет HTTP-запрос

Он инкапсулирует переменную $_SERVER и устраняет несоответствия в её значениях между различными веб-серверами. Также он предоставляет интерфейс для получения параметров запроса из $_POST, $_GET, $_COOKIES и параметров REST, отправленных через другие HTTP-методы, такие как PUT или DELETE.

Компонент Request настраивается как компонент приложения в yii\web\Application по умолчанию. Вы можете получить доступ к этому экземпляру через Yii::$app->request.

Дополнительную информацию и инструкции по использованию Request можно найти в статье руководства по запросам.

Публичные свойства

Свойство Тип Описание Определено в
$absoluteUrl строка Текущий запрашиваемый абсолютный URL. yii\web\Request
$acceptableContentTypes массив Типы содержимого, упорядоченные по качеству. yii\web\Request
$acceptableLanguages массив Языки, упорядоченные по уровню предпочтения. yii\web\Request
$authPassword строка|null Пароль, отправленный через HTTP-аутентификацию; null, если пароль не указан. yii\web\Request
$authUser строка|null Имя пользователя, отправленное через HTTP-аутентификацию; null, если имя пользователя не указано. yii\web\Request
$baseUrl строка Относительный URL приложения. yii\web\Request
$behaviors yii\base\Behavior[] Список поведений, прикрепленных к этому компоненту. yii\base\Component
$bodyParams массив Параметры запроса, заданные в теле запроса. yii\web\Request
$contentType строка Тип содержимого запроса. yii\web\Request
$cookieValidationKey строка Секретный ключ, используемый для проверки куки. yii\web\Request
$cookies yii\web\CookieCollection Коллекция куки. yii\web\Request
$csrfCookie массив Настройка для создания куки CSRF. yii\web\Request
$csrfParam строка Имя токена, используемого для предотвращения CSRF. yii\web\Request
$csrfToken строка Токен, используемый для проверки CSRF. yii\web\Request
$csrfTokenFromHeader строка Токен CSRF, отправленный через заголовок CSRF_HEADER браузером. yii\web\Request
$eTags массив Теги сущности. yii\web\Request
$enableCookieValidation булево Выполнять ли проверку куки, чтобы убедиться, что они не изменены. yii\web\Request
$enableCsrfCookie булево Использовать ли куки для сохранения токена CSRF. yii\web\Request
$enableCsrfValidation булево Включить ли проверку CSRF (Cross-Site Request Forgery). yii\web\Request
$headers yii\web\HeaderCollection Коллекция заголовков. yii\web\Request
$hostInfo строка|null Схема и имя хоста (с номером порта, если необходимо) URL запроса (например, `http://www. yii\web\Request
$hostName строка|null Часть имени хоста URL запроса (например, `www. yii\web\Request
$isAjax булево Является ли это AJAX-запросом (XMLHttpRequest). yii\web\Request
$isConsoleRequest булево Указывает, сделан ли текущий запрос через консоль. yii\base\Request
$isDelete булево Является ли это DELETE-запросом. yii\web\Request
$isFlash булево Является ли это запросом Adobe Flash или Adobe Flex. yii\web\Request
$isGet булево Является ли это GET-запросом. yii\web\Request
$isHead булево Является ли это HEAD-запросом. yii\web\Request
$isOptions булево Является ли это OPTIONS-запросом. yii\web\Request
$isPatch булево Является ли это PATCH-запросом. yii\web\Request
$isPjax булево Является ли это PJAX-запросом. yii\web\Request
$isPost булево Является ли это POST-запросом. yii\web\Request
$isPut булево Является ли это PUT-запросом. yii\web\Request
$isSecureConnection булево Запрос отправлен по защищенному каналу (https). yii\web\Request
$method строка Метод запроса, такой как GET, POST, HEAD, PUT, PATCH, DELETE. yii\web\Request
$methodParam строка Имя параметра POST, используемого для указания запроса PUT, PATCH или DELETE, проходящего через POST. yii\web\Request
$parsers массив Парсеры для преобразования тела HTTP-запроса в $bodyParams. yii\web\Request
$pathInfo строка Часть URL запроса после имени файла скрипта и перед вопросительным знаком. yii\web\Request
$port целое число Номер порта для небезопасных запросов. yii\web\Request
$preferredLanguage строка Язык, который приложение должно использовать. yii\web\Request
$queryParams массив Значения параметров запроса GET. yii\web\Request
$queryString строка Часть URL запроса, расположенная после знака вопроса. yii\web\Request
$rawBody строка Тело запроса. yii\web\Request
$referrer строка|null URL referrer, null если недоступен yii\web\Request
$scriptFile строка Путь к файлу скрипта входа. yii\web\Request
$scriptUrl строка Относительный URL скрипта входа. yii\web\Request
$securePort целое число Номер порта для защищённых запросов. yii\web\Request
$serverName строка Имя сервера, null если недоступно yii\web\Request
$serverPort целое число|null Номер порта сервера, null если недоступно yii\web\Request
$url строка Текущий запрашиваемый относительный URL. yii\web\Request
$userAgent строка|null User agent, null если недоступно yii\web\Request
$userHost строка|null Имя хоста пользователя, null если недоступно yii\web\Request
$userIP строка|null IP-адрес пользователя, null если недоступен yii\web\Request

Public Methods

Метод Описание Определено в
__call() Вызывает именованный метод, который не является методом класса. yii\base\Object
__clone() Этот метод вызывается после создания объекта путём клонирования существующего. yii\base\Component
__construct() Конструктор. yii\base\Object
__get() Возвращает значение свойства объекта. yii\base\Object
__isset() Проверяет, установлено ли свойство, т.е. определено и не равно null. yii\base\Object
__set() Устанавливает значение свойства объекта. yii\base\Object
__unset() Устанавливает свойство объекта в значение null. yii\base\Object
attachBehavior() Присоединяет поведение к компоненту. yii\base\Component
attachBehaviors() Присоединяет список поведений к компоненту. yii\base\Component
behaviors() Возвращает список поведений, по которым должен вести себя этот компонент. yii\base\Component
canGetProperty() Возвращает значение, указывающее, можно ли прочитать свойство. yii\base\Object
canSetProperty() Возвращает значение, указывающее, можно ли установить свойство. yii\base\Object
className() Возвращает полное имя этого класса. yii\base\Object
detachBehavior() Отсоединяет поведение от компонента. yii\base\Component
detachBehaviors() Отсоединяет все поведения от компонента. yii\base\Component
ensureBehaviors() Убеждается, что поведения, объявленные в behaviors(), присоединены к этому компоненту. yii\base\Component
get() Возвращает параметр GET с заданным именем. Если имя не указано, возвращает массив всех параметров GET. yii\web\Request
getAbsoluteUrl() Возвращает текущий запрашиваемый абсолютный URL. yii\web\Request
getAcceptableContentTypes() Возвращает типы контента, приемлемые для конечного пользователя. yii\web\Request
getAcceptableLanguages() Возвращает языки, приемлемые для конечного пользователя. yii\web\Request
getAuthPassword() yii\web\Request
getAuthUser() yii\web\Request
getBaseUrl() Возвращает относительный URL для приложения. yii\web\Request
getBehavior() Возвращает объект поведения с заданным именем. yii\base\Component
getBehaviors() Возвращает все поведения, присоединённые к этому компоненту. yii\base\Component
getBodyParam() Возвращает значение параметра тела запроса с заданным именем. yii\web\Request
getBodyParams() Возвращает параметры запроса, указанные в теле запроса. yii\web\Request
getContentType() Возвращает тип контента запроса. Заголовок Content-Type указывает тип MIME данных, содержащихся в getRawBody(), или, в случае метода HEAD, тип носителя, который был бы отправлен, если бы запрос был GET. yii\web\Request
getCookies() Возвращает коллекцию куки. yii\web\Request
getCsrfToken() Возвращает токен, используемый для проверки CSRF. yii\web\Request
getCsrfTokenFromHeader() yii\web\Request
getETags() Получает ETags. yii\web\Request
getHeaders() Возвращает коллекцию заголовков. yii\web\Request
getHostInfo() Возвращает схему и доменную часть текущего URL запроса. yii\web\Request
getHostName() Возвращает доменную часть текущего URL запроса. yii\web\Request
getIsAjax() Возвращает значение, указывающее, является ли это AJAX (XMLHttpRequest) запросом. yii\web\Request
getIsConsoleRequest() Возвращает значение, указывающее, является ли текущий запрос запросом через командную строку. yii\base\Request
getIsDelete() Возвращает значение, указывающее, является ли это запросом DELETE. yii\web\Request
getIsFlash() Возвращает значение, указывающее, является ли это запросом от Adobe Flash или Flex. yii\web\Request
getIsGet() Возвращает значение, указывающее, является ли это запросом GET. yii\web\Request
getIsHead() Возвращает значение, указывающее, является ли это запросом HEAD. yii\web\Request
getIsOptions() Возвращает значение, указывающее, является ли это запросом OPTIONS. yii\web\Request
getIsPatch() Возвращает значение, указывающее, является ли это запросом PATCH. yii\web\Request
getIsPjax() Возвращает значение, указывающее, является ли это запросом PJAX. yii\web\Request
getIsPost() Возвращает значение, указывающее, является ли это запросом POST. yii\web\Request
getIsPut() Возвращает значение, указывающее, является ли это запросом PUT. yii\web\Request
getIsSecureConnection() Возвращает значение, указывающее, отправлен ли запрос по защищённому каналу (https). yii\web\Request
getMethod() Возвращает метод текущего запроса (например, GET, POST, HEAD, PUT, PATCH, DELETE). yii\web\Request
getPathInfo() Возвращает путь информации текущего запрашиваемого URL. yii\web\Request
getPort() Возвращает порт для использования при запросах без шифрования. yii\web\Request
getPreferredLanguage() Возвращает предпочтительный язык пользователя, который должно использовать это приложение. yii\web\Request
getQueryParam() Возвращает значение параметра GET с заданным именем. yii\web\Request
getQueryParams() Возвращает параметры запроса, указанные в $queryString. yii\web\Request
getQueryString() Возвращает часть URL запроса, расположенную после знака вопроса. yii\web\Request
getRawBody() Возвращает тело HTTP запроса в сыром виде. yii\web\Request
getReferrer() Возвращает URL источника. yii\web\Request
getScriptFile() Возвращает путь к файлу скрипта входа. yii\web\Request
getScriptUrl() Возвращает относительный URL скрипта входа. yii\web\Request
getSecurePort() Возвращает порт для использования в защищённых запросах. yii\web\Request
getServerName() Возвращает имя сервера. yii\web\Request
getServerPort() Возвращает номер порта сервера. yii\web\Request
getUrl() Возвращает запрашиваемый в данный момент относительный URL. yii\web\Request
getUserAgent() Возвращает данные пользовательского агента. yii\web\Request
getUserHost() Возвращает имя хоста пользователя. yii\web\Request
getUserIP() Возвращает IP адрес пользователя. yii\web\Request
hasEventHandlers() Возвращает значение, указывающее, есть ли обработчики для указанного события. yii\base\Component
hasMethod() Возвращает значение, указывающее, определён ли метод. yii\base\Object
hasProperty() Возвращает значение, указывающее, определено ли свойство. yii\base\Object
init() Инициализирует объект. yii\base\Object
off() Отсоединяет существующий обработчик событий от этого компонента. yii\base\Component
on() Присоединяет обработчик событий к событию. yii\base\Component
parseAcceptHeader() Парсит заданный Accept (или Accept-Language) заголовок. yii\web\Request
post() Возвращает параметр POST с заданным именем. Если имя не указано, возвращает массив всех параметров POST. yii\web\Request
resolve() Разрешает текущий запрос в маршрут и связанные параметры. yii\web\Request
setAcceptableContentTypes() Устанавливает допустимые типы содержимого. yii\web\Request
setAcceptableLanguages() yii\web\Request
setBaseUrl() Устанавливает относительный URL для приложения. yii\web\Request
setBodyParams() Устанавливает параметры тела запроса. yii\web\Request
setHostInfo() Устанавливает схему и часть хоста URL приложения. yii\web\Request
setIsConsoleRequest() Устанавливает значение, указывающее, сделан ли текущий запрос через командную строку. yii\base\Request
setPathInfo() Устанавливает информацию о пути текущего запроса. yii\web\Request
setPort() Устанавливает порт для использования в незащищённых запросах. yii\web\Request
setQueryParams() Устанавливает параметры запроса $queryString. yii\web\Request
setRawBody() Устанавливает тело HTTP запроса в сыром виде; этот метод в основном используется скриптами тестов для моделирования сырых HTTP запросов. yii\web\Request
setScriptFile() Устанавливает путь к файлу скрипта входа. yii\web\Request
setScriptUrl() Устанавливает относительный URL для скрипта входа приложения. yii\web\Request
setSecurePort() Устанавливает порт для использования в защищённых запросах. yii\web\Request
setUrl() Устанавливает запрашиваемый в данный момент относительный URL. yii\web\Request
trigger() Вызывает событие. yii\base\Component
validateCsrfToken() Выполняет проверку CSRF. yii\web\Request

Защищенные методы

Метод Описание Определено в
createCsrfCookie() Создаёт куки с случайно сгенерированным CSRF токеном. yii\web\Request
generateCsrfToken() Генерирует незамаскированный случайный токен, используемый для проверки CSRF. yii\web\Request
loadCookies() Преобразует $_COOKIE в массив yii\web\Cookie. yii\web\Request
loadCsrfToken() Загружает CSRF токен из куки или сессии. yii\web\Request
resolvePathInfo() Разрешает часть информации о пути из запрашиваемого URL. yii\web\Request
resolveRequestUri() Разрешает часть URI запроса для текущего запрашиваемого URL. yii\web\Request

Константы

Константа Значение Описание Определено в
CSRF_HEADER 'X-CSRF-Token' Имя HTTP заголовка для отправки CSRF токена. yii\web\Request
CSRF_MASK_LENGTH 8 Длина маски CSRF токена. Устарело начиная с версии 2.0.12: длина маски теперь равна длине токена. yii\web\Request

Подробное описание свойств

$absoluteUrl public только для чтения свойство

Текущий запрашиваемый абсолютный URL.

public string getAbsoluteUrl ( )

$acceptableContentTypes public свойство

Типы содержимого, упорядоченные по оценке качества. Типы с наивысшими оценками будут возвращаться первыми. Ключи массива — типы содержимого, а значения массива — соответствующая оценка качества и другие параметры, указанные в заголовке.

public array getAcceptableContentTypes ( )
public void setAcceptableContentTypes ( $value )

$acceptableLanguages public свойство

Языки, упорядоченные по уровню предпочтения. Первый элемент представляет наиболее предпочтительный язык.

public array getAcceptableLanguages ( )
public void setAcceptableLanguages ( $value )

$authPassword public только для чтения свойство

Пароль, отправленный через аутентификацию HTTP, null, если пароль не указан

public string|null getAuthPassword ( )

$authUser общественное только для чтения свойство

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

public string|null getAuthUser ( )

$baseUrl общественное свойство

Относительный URL-адрес приложения

public string getBaseUrl ( )
public void setBaseUrl ( $value )

$bodyParams общественное свойство

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

public array getBodyParams ( )
public void setBodyParams ( $values )

$contentType общественное только для чтения свойство

Тип содержимого запроса. Null возвращается, если эта информация недоступна.

public string getContentType ( )

$cookieValidationKey общественное свойство

Секретный ключ, используемый для проверки куки. Это свойство должно быть установлено, если $enableCookieValidation равно true.

public string $cookieValidationKey = null

$cookies общественное только для чтения свойство

Коллекция куки.

public yii\web\CookieCollection getCookies ( )

$csrfCookie общественное свойство

Настройка для создания куки CSRF. Это свойство используется только тогда, когда оба $enableCsrfValidation и $enableCsrfCookie равны true.

public array $csrfCookie = ['httpOnly' => true]

$csrfParam общественное свойство

Имя маркера, используемого для предотвращения CSRF. По умолчанию равно '_csrf'. Это свойство используется только тогда, когда $enableCsrfValidation равно true.

public string $csrfParam = '_csrf'

$csrfToken общественное только для чтения свойство

Маркер, используемый для проверки CSRF.

public string getCsrfToken ( $regenerate = false )

$csrfTokenFromHeader общественное только для чтения свойство

CSRF-токен, отправленный через CSRF_HEADER браузером. Возвращает null, если такой заголовок не отправлен.

public string getCsrfTokenFromHeader ( )

$eTags общественное только для чтения свойство

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

public array getETags ( )

$enableCookieValidation общественное свойство

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

public boolean $enableCookieValidation = true

$enableCsrfCookie общественное свойство

Использовать куки для сохранения токена CSRF. Если false, токен CSRF будет сохранен в сессии под именем $csrfParam. Обратите внимание, что, хотя сохранение токенов CSRF в сессии повышает безопасность, это требует запуска сессии для каждой страницы, что ухудшит производительность вашего сайта.

public boolean $enableCsrfCookie = true

$enableCsrfValidation общественное свойство

Включить проверку CSRF (Cross-Site Request Forgery). По умолчанию равно true. Когда проверка CSRF включена, формы, отправляемые в веб-приложение Yii, должны исходить из того же приложения. Если нет, будет поднято исключение 400 HTTP.

Примечание: эта функция требует, чтобы клиентский браузер принимал куки. Также для использования этой функции формы, отправляемые методом POST, должны содержать скрытый элемент управления с именем, заданным в $csrfParam. Вы можете использовать yii\helpers\Html::beginForm() для генерации этого скрытого элемента управления.

В JavaScript вы можете получить значения $csrfParam и $csrfToken соответственно с помощью yii.getCsrfParam() и yii.getCsrfToken(). Актив yii\web\YiiAsset должен быть зарегистрирован. Также необходимо включить теги мета-данных CSRF на ваших страницах, используя yii\helpers\Html::csrfMetaTags().

См. также:

  • yii\web\Controller::$enableCsrfValidation
  • http://en.wikipedia.org/wiki/Cross-site_request_forgery
public boolean $enableCsrfValidation = true

$headers общественное только для чтения свойство

Коллекция заголовков

public yii\web\HeaderCollection getHeaders ( )

$hostInfo общественное свойство

Схема и имя хоста (с номером порта, если необходимо) части URL-адреса запроса (например, http://www.yiiframework.com), null, если не может быть получен из $_SERVER и не был установлен.

public string|null getHostInfo ( )
public void setHostInfo ( $value )

$hostName общественное только для чтения свойство

Часть имени хоста URL-адреса запроса (например, www.yiiframework.com)

public string|null getHostName ( )

$isAjax общественное только для чтения свойство

Является ли это AJAX-запросом (XMLHttpRequest).

public boolean getIsAjax ( )

$isDelete общественное только для чтения свойство

Является ли это запросом DELETE.

public boolean getIsDelete ( )

$isFlash общественное только для чтения свойство

Является ли это запросом Adobe Flash или Adobe Flex.

public boolean getIsFlash ( )

$isGet общественное только для чтения свойство

Является ли это запросом GET.

public boolean getIsGet ( )

$isHead общественное только для чтения свойство

Является ли это запросом HEAD.

public boolean getIsHead ( )

$isOptions общественное только для чтения свойство

Является ли это запросом OPTIONS.

public boolean getIsOptions ( )

$isPatch общественное только для чтения свойство

Является ли это запросом PATCH.

public boolean getIsPatch ( )

$isPjax общественное только для чтения свойство

Является ли это запросом PJAX

public boolean getIsPjax ( )

$isPost общественное только для чтения свойство

Является ли это запросом POST.

public boolean getIsPost ( )

$isPut общественное только для чтения свойство

Является ли это запросом PUT.

public boolean getIsPut ( )

$isSecureConnection общественное только для чтения свойство

Если запрос отправлен по защищенному каналу (https)

public boolean getIsSecureConnection ( )

$method общественное только для чтения свойство

Метод запроса, такой как GET, POST, HEAD, PUT, PATCH, DELETE. Возвращаемое значение приводится к верхнему регистру.

public string getMethod ( )

$methodParam общественное свойство

Имя параметра POST, используемого для указания того, является ли запрос PUT, PATCH или DELETE, проходящий через POST. По умолчанию равно '_method'.

См. также:

  • getMethod()
  • getBodyParams()
public string $methodParam = '_method'

$parsers общественное свойство

Парсеры для преобразования тела HTTP-запроса в сыром виде в $bodyParams. Ключи массива — типы запроса Content-Types, а значения массива — соответствующие конфигурации для создания объектов парсеров. Парсер должен реализовывать yii\web\RequestParserInterface.

Чтобы включить разбор JSON-запросов, вы можете использовать класс yii\web\JsonParser, как в следующем примере:

[
    'application/json' => 'yii\web\JsonParser',
]

Чтобы зарегистрировать парсер для разбора всех типов запросов, вы можете использовать '*' в качестве ключа массива. Он будет использоваться в качестве резервного варианта, если не найдётся совпадение с другим типом.

См. также getBodyParams().

public array $parsers = []

$pathInfo общественное свойство

Часть URL-адреса запроса, которая находится после скрипта входа и перед вопросительным знаком. Обратите внимание, что возвращённая информация о пути уже декодирована по URL.

public string getPathInfo ( )
public void setPathInfo ( $value )

$port общественное свойство

Номер порта для небезопасных запросов.

public integer getPort ( )
public void setPort ( $value )

$preferredLanguage общественное только для чтения свойство

Язык, который должно использовать приложение.

public string getPreferredLanguage ( array $languages = [] )

$queryParams общественное свойство

Значения параметров GET запроса.

public array getQueryParams ( )
public void setQueryParams ( $values )

$queryString общественное только для чтения свойство

Часть URL-адреса запроса, которая находится после вопросительного знака

public string getQueryString ( )

$rawBody общественное свойство

Тело запроса

public string getRawBody ( )
public void setRawBody ( $rawBody )

$referrer общественное только для чтения свойство

URL-ссылка-источник, null, если недоступна

public string|null getReferrer ( )

$scriptFile общественное свойство

Путь к файлу скрипта входа

public string getScriptFile ( )
public void setScriptFile ( $value )

$scriptUrl общественное свойство

Относительный URL-адрес скрипта входа.

public string getScriptUrl ( )
public void setScriptUrl ( $value )

$securePort общественное свойство

Номер порта для защищённых запросов.

public integer getSecurePort ( )
public void setSecurePort ( $value )

$serverName общественное только для чтения свойство

Имя сервера, null, если недоступно

public string getServerName ( )

$serverPort общественное только для чтения свойство

Номер порта сервера, null, если недоступен

public integer|null getServerPort ( )

$url общественное свойство

Текущий запрашиваемый относительный URL. Обратите внимание, что возвращаемый URI может быть закодирован по URL в зависимости от клиента.

public string getUrl ( )
public void setUrl ( $value )

$userAgent общественное только для чтения свойство

Имя пользователя агента, null, если недоступно

public string|null getUserAgent ( )

$userHost общественное только для чтения свойство

Имя хоста пользователя, null, если недоступно

public string|null getUserHost ( )

$userIP общественное только для чтения свойство

IP-адрес пользователя, null, если недоступно

public string|null getUserIP ( )

Подробное описание методов

createCsrfCookie() защищенный метод

Создаёт cookie с случайным генерируемым токеном CSRF.

Начальные значения, указанные в $csrfCookie, будут применены к сгенерированному cookie.

См. также $enableCsrfValidation.

защищенный yii\web\Cookie createCsrfCookie ( $token )
$token строка

Токен CSRF

return yii\web\Cookie

Сгенерированный cookie

generateCsrfToken() защищенный метод

Генерирует незамаскированный случайный токен, используемый для проверки CSRF.

защищенный строка generateCsrfToken ( )
return строка

Случайный токен для проверки CSRF.

get() публичный метод

Возвращает параметр GET с заданным именем. Если имя не указано, возвращает массив всех параметров GET.

публичный массив|смешанный get ( $name = null, $defaultValue = null )
$name строка

Имя параметра

$defaultValue смешанный

Значение параметра по умолчанию, если параметр не существует.

getAbsoluteUrl() публичный метод

Возвращает текущий запрашиваемый абсолютный URL.

Это сокращение для конкатенации $hostInfo и $url.

публичный строка getAbsoluteUrl ( )
return строка

Текущий запрашиваемый абсолютный URL.

getAcceptableContentTypes() публичный метод

Возвращает типы содержимого, приемлемые для конечного пользователя.

Это определяется по HTTP-заголовку Accept. Например,

$_SERVER['HTTP_ACCEPT'] = 'text/plain; q=0.5, application/json; version=1.0, application/xml; version=2.0;';
$types = $request->getAcceptableContentTypes();
print_r($types);
// displays:
// [
//     'application/json' => ['q' => 1, 'version' => '1.0'],
//      'application/xml' => ['q' => 1, 'version' => '2.0'],
//           'text/plain' => ['q' => 0.5],
// ]
публичный массив getAcceptableContentTypes ( )
return массив

Типы содержимого, упорядоченные по качеству. Типы с наивысшими баллами будут возвращены первыми. Ключи массива — это типы содержимого, а значения массива — соответствующий балл качества и другие параметры, заданные в заголовке.

getAcceptableLanguages() публичный метод

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

Это определяется по HTTP-заголовку Accept-Language.

публичный массив getAcceptableLanguages ( )
return массив

Языки, упорядоченные по уровню предпочтения. Первый элемент представляет наиболее предпочтительный язык.

getAuthPassword() публичный метод

публичный строка|null getAuthPassword ( )
return строка|null

Пароль, отправленный через аутентификацию HTTP, null, если пароль не задан

getAuthUser() публичный метод

публичный строка|null getAuthUser ( )
return строка|null

Имя пользователя, отправленное через аутентификацию HTTP, null, если имя пользователя не задано

getBaseUrl() публичный метод

Возвращает относительный URL приложения.

Аналогично $scriptUrl, за исключением того, что он не включает имя файла скрипта, и конечные слэши удаляются.

См. также setScriptUrl().

публичный строка getBaseUrl ( )
return строка

Относительный URL приложения

getBodyParam() публичный метод

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

Если параметр не существует, возвращается второй параметр, переданный в этот метод.

См. также:

  • getBodyParams()
  • setBodyParams()
публичный смешанный getBodyParam ( $name, $defaultValue = null )
$name строка

Имя параметра

$defaultValue смешанный

Значение параметра по умолчанию, если параметр не существует.

return смешанный

Значение параметра

getBodyParams() публичный метод

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

Параметры запроса определяются с помощью парсеров, настроенных в свойстве $parsers. Если для текущего $contentType нет настроенных парсеров, он использует PHP-функцию mb_parse_str() для анализа тела запроса.

См. также:

  • getMethod()
  • getBodyParam()
  • setBodyParams()
публичный массив getBodyParams ( )
return массив

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

throws yii\base\InvalidConfigException

если зарегистрированный парсер не реализует yii\web\RequestParserInterface.

getContentType() публичный метод

Возвращает тип содержимого запроса. Заголовок Content-Type указывает тип MIME данных, содержащихся в getRawBody(), или, в случае метода HEAD, тип носителя, который был бы отправлен, если бы запрос был GET.

Для типов MIME, ожидаемых пользователем в ответе, см. $acceptableContentTypes.

публичный строка getContentType ( )
return строка

Тип содержимого запроса. Возвращает null, если эта информация недоступна.

getCookies() публичный метод

Возвращает коллекцию cookie.

С помощью возвращенной коллекции cookie вы можете получить доступ к cookie с помощью следующего синтаксиса:

$cookie = $request->cookies['name']
if ($cookie !== null) {
    $value = $cookie->value;
}

// alternatively
$value = $request->cookies->getValue('name');
публичный yii\web\CookieCollection getCookies ( )
return yii\web\CookieCollection

Коллекция cookie.

getCsrfToken() публичный метод

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

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

публичный строка getCsrfToken ( $regenerate = false )
$regenerate boolean

Передать ли токен CSRF. При значении true каждый вызов этого метода будет генерировать новый токен CSRF и сохранять его (в сессии или cookie).

return строка

Токен, используемый для проверки CSRF.

getCsrfTokenFromHeader() публичный метод

public string getCsrfTokenFromHeader ( )
return string

Токен CSRF, отправленный через CSRF_HEADER браузером. Возвращает Null, если такой заголовок не отправлен.

getETags() public method

Получает ETags.

public array getETags ( )
return array

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

getHeaders() public method

Возвращает коллекцию заголовков.

Коллекция заголовков содержит входящие HTTP заголовки.

public yii\web\HeaderCollection getHeaders ( )
return yii\web\HeaderCollection

Коллекция заголовков

getHostInfo() public method

Возвращает схему и доменную часть текущего URL запроса.

Возвращаемый URL не содержит конечной косой черты.

По умолчанию это значение основано на информации о запросе пользователя. Этот метод вернет значение $_SERVER['HTTP_HOST'] , если оно доступно, или $_SERVER['SERVER_NAME'] , если нет. Вы можете ознакомиться с документацией PHP для получения дополнительной информации об этих переменных.

Вы можете явно указать его, установив свойство hostInfo.

Предупреждение: В зависимости от конфигурации сервера эта информация может быть ненадежной и может быть подделана пользователем, отправляющим HTTP-запрос. Если веб-сервер настроен на обслуживание одного и того же сайта независимо от значения заголовка Host, это значение ненадежно. В таких ситуациях вам следует либо исправить конфигурацию своего веб-сервера, либо явно установить значение, установив свойство hostInfo. Если у вас нет доступа к конфигурации сервера, вы можете настроить фильтр yii\filters\HostControl на уровне приложения, чтобы защититься от подобных атак.

См. также setHostInfo().

public string|null getHostInfo ( )
return string|null

Схема и имя хоста (с номером порта, если необходимо) части URL запроса (например, http://www.yiiframework.com), null, если не может быть получено из $_SERVER и не было установлено.

getHostName() public method (доступно начиная с версии 2.0.10)

Возвращает доменную часть текущего URL запроса.

Значение вычисляется из текущего свойства hostInfo.

Предупреждение: Содержание этого значения может быть ненадежным в зависимости от конфигурации сервера. Обратитесь к getHostInfo() для получения дополнительной информации.

См. также getHostInfo().

public string|null getHostName ( )
return string|null

Часть имени хоста URL запроса (например, www.yiiframework.com)

getIsAjax() public method

Возвращает, является ли это AJAX (XMLHttpRequest) запросом.

Обратите внимание, что jQuery не устанавливает заголовок в случае запросов между доменами: https://stackoverflow.com/questions/8163703/cross-domain-ajax-doesnt-send-x-requested-with-header

public boolean getIsAjax ( )
return boolean

Является ли это AJAX (XMLHttpRequest) запросом.

getIsDelete() public method

Возвращает, является ли это запросом DELETE.

public boolean getIsDelete ( )
return boolean

Является ли это запросом DELETE.

getIsFlash() public method

Возвращает, является ли это запросом от Adobe Flash или Flex.

public boolean getIsFlash ( )
return boolean

Является ли это запросом от Adobe Flash или Adobe Flex.

getIsGet() public method

Возвращает, является ли это запросом GET.

public boolean getIsGet ( )
return boolean

Является ли это запросом GET.

getIsHead() public method

Возвращает, является ли это запросом HEAD.

public boolean getIsHead ( )
return boolean

Является ли это запросом HEAD.

getIsOptions() public method

Возвращает, является ли это запросом OPTIONS.

public boolean getIsOptions ( )
return boolean

Является ли это запросом OPTIONS.

getIsPatch() public method

Возвращает, является ли это запросом PATCH.

public boolean getIsPatch ( )
return boolean

Является ли это запросом PATCH.

getIsPjax() public method

Возвращает, является ли это запросом PJAX

public boolean getIsPjax ( )
return boolean

Является ли это запросом PJAX

getIsPost() public method

Возвращает, является ли это запросом POST.

public boolean getIsPost ( )
return boolean

Является ли это запросом POST.

getIsPut() public method

Возвращает, является ли это запросом PUT.

public boolean getIsPut ( )
return boolean

Является ли это запросом PUT.

getIsSecureConnection() public method

Возвращает, отправлен ли запрос по защищенному каналу (https).

public boolean getIsSecureConnection ( )
return boolean

Отправлен ли запрос по защищенному каналу (https)

getMethod() public method

Возвращает метод текущего запроса (например, GET, POST, HEAD, PUT, PATCH, DELETE).

public string getMethod ( )
return string

Метод запроса, такой как GET, POST, HEAD, PUT, PATCH, DELETE. Возвращаемое значение преобразуется в верхний регистр.

getPathInfo() public method

Возвращает информацию о пути текущего запрошенного URL.

Информация о пути относится к части, которая следует за начальным скриптом и предшествует вопросительному знаку (строка запроса). Начальные и конечные косые черты удаляются.

public строка getPathInfo ( )
возврат строка

Часть URL запроса, которая следует за начальным скриптом и предшествует вопросительному знаку. Обратите внимание, что возвращаемая информация о пути уже декодирована по URL.

выбрасывает yii\base\InvalidConfigException

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

getPort() общедоступный метод

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

По умолчанию 80, или порт, указанный сервером, если текущий запрос небезопасен.

См. также setPort().

public целое число getPort ( )
возврат целое число

Номер порта для небезопасных запросов.

getPreferredLanguage() общедоступный метод

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

Решение языка основано на предпочтительных языках пользователя и языках, поддерживаемых приложением. Метод попытается найти наилучшее совпадение.

public строка getPreferredLanguage ( массив $languages = [] )
$languages массив

Список языков, поддерживаемых приложением. Если он пустой, текущий язык приложения будет возвращён без дальнейшей обработки.

возврат строка

Язык, который приложение должно использовать.

getQueryParam() общедоступный метод

Возвращает значение параметра GET по имени.

Если параметр GET не существует, возвращается второй параметр, переданный этому методу.

См. также getBodyParam().

public смешанный getQueryParam ( $name, $defaultValue = null )
$name строка

Имя параметра GET.

$defaultValue смешанный

Значение параметра по умолчанию, если параметр GET не существует.

возврат смешанный

Значение параметра GET

getQueryParams() общедоступный метод

Возвращает параметры запроса, заданные в $queryString.

Этот метод вернёт содержимое $_GET если параметры не были явно заданы.

См. также setQueryParams().

public массив getQueryParams ( )
возврат массив

Значения параметров GET запроса.

getQueryString() общедоступный метод

Возвращает часть URL запроса, которая следует за вопросительным знаком.

public строка getQueryString ( )
возврат строка

Часть URL запроса, которая следует за вопросительным знаком

getRawBody() общедоступный метод

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

public строка getRawBody ( )
возврат строка

Тело запроса

getReferrer() общедоступный метод

Возвращает URL-ссылку referrer.

public строка|null getReferrer ( )
возврат строка|null

URL referrer, null если не доступен

getScriptFile() общедоступный метод

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

Реализация по умолчанию просто вернёт $_SERVER['SCRIPT_FILENAME'].

public строка getScriptFile ( )
возврат строка

Путь к файлу начального скрипта

выбрасывает yii\base\InvalidConfigException

getScriptUrl() общедоступный метод

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

Реализация этого метода ссылается на Zend_Controller_Request_Http в Zend Framework.

public строка getScriptUrl ( )
возврат строка

Относительный URL начального скрипта.

выбрасывает yii\base\InvalidConfigException

если невозможно определить URL начального скрипта

getSecurePort() общедоступный метод

Возвращает порт, который следует использовать для защищённых запросов.

По умолчанию 443, или порт, указанный сервером, если текущий запрос защищён.

См. также setSecurePort().

public целое число getSecurePort ( )
возврат целое число

Номер порта для защищённых запросов.

getServerName() общедоступный метод

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

public строка getServerName ( )
возврат строка

Имя сервера, null если не доступно

getServerPort() общедоступный метод

Возвращает номер порта сервера.

public целое число|null getServerPort ( )
возврат целое число|null

Номер порта сервера, null если не доступен

getUrl() общедоступный метод

Возвращает запрашиваемый относительный URL.

Это относится к части URL, которая следует за $hostInfo. Включает $queryString, если таковой имеется.

public строка getUrl ( )
возврат строка

Текущий запрашиваемый относительный URL. Обратите внимание, что URI, возвращаемый может быть закодирован в URL в зависимости от клиента.

выбрасывает yii\base\InvalidConfigException

если URL не может быть определён из-за необычной конфигурации сервера

getUserAgent() общедоступный метод

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

public строка|null getUserAgent ( )
возврат строка|null

Пользовательский агент, null если недоступен

getUserHost() общедоступный метод

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

public строка|null getUserHost ( )
возврат строка|null

Имя хоста пользователя, null если недоступно

getUserIP() общедоступный метод

Возвращает IP-адрес пользователя.

public string|null getUserIP ( )
return string|null

IP-адрес пользователя, null, если не доступен

loadCookies() protected method

Преобразует $_COOKIE в массив yii\web\Cookie.

protected array loadCookies ( )
return array

Куки, полученные из запроса

throws yii\base\InvalidConfigException

если $cookieValidationKey не задан, когда $enableCookieValidation равен true

loadCsrfToken() protected method

Загружает токен CSRF из куки или сессии.

protected string loadCsrfToken ( )
return string

Загруженный токен CSRF из куки или сессии. Null возвращается, если куки или сессия не содержат токен CSRF.

parseAcceptHeader() public method

Парсит заданный заголовок Accept (или Accept-Language).

Этот метод возвращает допустимые значения с их коэффициентами качества и соответствующими параметрами, как указано в заданном заголовке Accept. Ключи массива результата — это допустимые значения, а значения массива — соответствующие коэффициенты качества и параметры. Допустимые значения с наивысшими коэффициентами качества будут возвращены первыми. Например,

$header = 'text/plain; q=0.5, application/json; version=1.0, application/xml; version=2.0;';
$accepts = $request->parseAcceptHeader($header);
print_r($accepts);
// displays:
// [
//     'application/json' => ['q' => 1, 'version' => '1.0'],
//      'application/xml' => ['q' => 1, 'version' => '2.0'],
//           'text/plain' => ['q' => 0.5],
// ]
public array parseAcceptHeader ( $header )
$header string

Заголовок для парсинга

return array

Допустимые значения, отсортированные по коэффициенту качества. Значения с наивысшими коэффициентами будут возвращены первыми.

post() public method

Возвращает параметр POST с заданным именем. Если имя не указано, возвращает массив всех параметров POST.

public array|mixed post ( $name = null, $defaultValue = null )
$name string

Имя параметра

$defaultValue mixed

Значение параметра по умолчанию, если параметр не существует.

resolve() public method

Разрешает текущий запрос до маршрута и связанных параметров.

public array resolve ( )
return array

Первый элемент — маршрут, второй — связанные параметры.

throws yii\web\NotFoundHttpException

если запрос не может быть разрешен.

resolvePathInfo() protected method

Разрешает часть path info текущего запрошенного URL.

Path info — это часть, которая следует за скриптом входа и предшествует вопросительному знаку (строка запроса). Начальные слеши удаляются, конечные — сохраняются.

protected string resolvePathInfo ( )
return string

Часть URL запроса, находящаяся после скрипта входа и перед вопросительным знаком. Обратите внимание, возвращаемый path info декодирован.

throws yii\base\InvalidConfigException

если path info не может быть определена из-за неожиданной конфигурации сервера

resolveRequestUri() protected method

Разрешает часть request URI для текущего запрошенного URL.

Это часть, которая находится после части $hostInfo. Она включает часть $queryString, если она есть. Реализация этого метода ссылается на Zend_Controller_Request_Http в Zend Framework.

protected string|boolean resolveRequestUri ( )
return string|boolean

Часть request URI для текущего запрошенного URL. Обратите внимание, что возвращаемый URI может быть закодирован в URL в зависимости от клиента.

throws yii\base\InvalidConfigException

если request URI не может быть определен из-за необычной конфигурации сервера

setAcceptableContentTypes() public method

Устанавливает допустимые типы содержимого.

См. getAcceptableContentTypes() для формата параметра.

См. также:

  • getAcceptableContentTypes()
  • parseAcceptHeader()
public void setAcceptableContentTypes ( $value )
$value array

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

setAcceptableLanguages() public method

public void setAcceptableLanguages ( $value )
$value array

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

setBaseUrl() public method

Устанавливает относительный URL приложения.

По умолчанию URL определяется на основе URL скрипта входа. Этот метод-сеттер предоставляется в случае необходимости изменить это поведение.

public void setBaseUrl ( $value )
$value string

Относительный URL приложения

setBodyParams() public method

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

См. также:

  • getBodyParam()
  • getBodyParams()
public void setBodyParams ( $values )
$values array

Параметры тела запроса (имя-значение)

setHostInfo() public method

Устанавливает схему и доменную часть URL приложения.

Этот сеттер предоставляется в случае, если схема и имя хоста не могут быть определены на определённых веб-серверах.

См. также getHostInfo() для заметок по безопасности этого свойства.

public void setHostInfo ( $value )
$value string|null

Схема и доменная часть URL приложения. Конечные слеши будут удалены.

setPathInfo() public method

Устанавливает path info текущего запроса.

Этот метод в основном предназначен для целей тестирования.

public void setPathInfo ( $value )
$value string

Path info текущего запроса

setPort() public method

Устанавливает порт для использования для незащищённых запросов.

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

public void setPort ( $value )
$value integer

Номер порта.

setQueryParams() public method

Устанавливает параметры запроса $queryString.

См. также:

  • getQueryParam()
  • getQueryParams()
public void setQueryParams ( $values )
$values массив

Параметры запроса (имя-значение)

setRawBody() public метод

Устанавливает тело HTTP-запроса в сыром виде. Этот метод в основном используется тестовыми сценариями для имитации HTTP-запросов в сыром формате.

public void setRawBody ( $rawBody )
$rawBody строка

Тело запроса

setScriptFile() public метод

Устанавливает путь к файлу скрипта входа.

Путь к файлу скрипта входа обычно можно получить из $_SERVER['SCRIPT_FILENAME']. Если ваша конфигурация сервера не возвращает правильное значение, вы можете настроить это свойство, чтобы оно соответствовало действительности.

public void setScriptFile ( $value )
$value строка

Путь к файлу скрипта входа.

setScriptUrl() public метод

Устанавливает относительный URL-адрес скрипта входа приложения.

Этот метод сеттера предоставляется на случай, если URL-адрес скрипта входа не может быть определен на определенных веб-серверах.

public void setScriptUrl ( $value )
$value строка

Относительный URL-адрес скрипта входа приложения.

setSecurePort() public метод

Устанавливает порт для использования в защищённых запросах.

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

public void setSecurePort ( $value )
$value целое число

Номер порта.

setUrl() public метод

Устанавливает текущий запрашиваемый относительный URL.

URI должен ссылаться на часть, которая находится после $hostInfo. Обратите внимание, что URI должен быть закодирован в формате URL.

public void setUrl ( $value )
$value строка

URI запроса, который нужно установить

validateCsrfToken() public метод

Выполняет проверку CSRF.

Этот метод проверяет предоставленный пользователем токен CSRF, сравнивая его с токеном, хранящимся в cookie или сессии. Этот метод в основном вызывается в yii\web\Controller::beforeAction().

Обратите внимание, что метод НЕ выполнит проверку CSRF, если $enableCsrfValidation имеет значение false или HTTP-метод относится к GET, HEAD или OPTIONS.

public boolean validateCsrfToken ( $clientSuppliedToken = null )
$clientSuppliedToken строка

Предоставленный пользователем токен CSRF для проверки. Если null, токен будет получен из поля POST $csrfParam или HTTP-заголовка. Этот параметр доступен с версии 2.0.4.

return boolean

Является ли токен CSRF действительным. Если $enableCsrfValidation равен false, этот метод вернёт true.

© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-web-request.html

Spec-Zone.ru

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