Класс 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().
См. также:
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'.
См. также:
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() публичный метод
Возвращает значение параметра тела запроса с заданным именем.
Если параметр не существует, возвращается второй параметр, переданный в этот метод.
См. также:
| публичный смешанный getBodyParam ( $name, $defaultValue = null ) | ||
|---|---|---|
| $name | строка |
Имя параметра |
| $defaultValue | смешанный |
Значение параметра по умолчанию, если параметр не существует. |
| return | смешанный |
Значение параметра |
getBodyParams() публичный метод
Возвращает параметры запроса, указанные в теле запроса.
Параметры запроса определяются с помощью парсеров, настроенных в свойстве $parsers. Если для текущего $contentType нет настроенных парсеров, он использует PHP-функцию mb_parse_str() для анализа тела запроса.
См. также:
| публичный массив 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 запроса (например, |
getHostName() public method (доступно начиная с версии 2.0.10)
Возвращает доменную часть текущего URL запроса.
Значение вычисляется из текущего свойства hostInfo.
Предупреждение: Содержание этого значения может быть ненадежным в зависимости от конфигурации сервера. Обратитесь к getHostInfo() для получения дополнительной информации.
См. также getHostInfo().
| public string|null getHostName ( ) | ||
|---|---|---|
| return | string|null |
Часть имени хоста URL запроса (например, |
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() для формата параметра.
См. также:
| 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
Устанавливает параметры тела запроса.
См. также:
| 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.
См. также:
| 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