Класс Request

__call()source public

__call( string $name , array $params )

Обработчик отсутствующего метода, обрабатывает обертывание методов старого стиля isAjax()

Параметры

строка $name

Вызываемый метод

массив $params

Массив параметров для вызова метода

Возвращает

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

Исключения

BadMethodCallException
при вызове недействительного метода.

__construct()source public

__construct( string|array $config [] )

Создаёт новый объект запроса.

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

• post Данные POST или данные, не являющиеся строкой запроса
• query Дополнительные данные из строки запроса.
• files Данные загружаемых файлов в формате $_FILES.
• cookies Куки для этого запроса.
• environment Данные $_SERVER и $_ENV.
• url URL без базового пути для запроса.
• base Базовый URL для запроса.
• webroot Директория webroot для запроса.
• input Данные, которые поступали бы из php://input, это полезно для моделирования
• session Экземпляр объекта Session для запросов с данными put, patch или delete.

Параметры

строка|массив $config необязательно []

Массив данных запроса для создания запроса.

__get()source public

__get( string $name )

Магический метод получения позволяет получить доступ к обработанным параметрам маршрутизации напрямую в объекте.

Позволяет получить доступ к $this->params['controller'] через $this->controller

Параметры

строка $name

Доступное свойство.

Возвращает

смешанный тип
Значение параметра или null.

__isset()source public

__isset( string $name )

Магический метод isset позволяет проверять isset/empty на параметрах маршрутизации.

Параметры

строка $name

Доступное свойство.

Возвращает

булево
Существование

_acceptHeaderDetector()source protected

_acceptHeaderDetector( array $detect )

Определяет, присутствует ли определённый заголовок accept.

Параметры

массив $detect

Массив параметров детектора.

Возвращает

булево
Является ли запрос нужного типа.

_base()source protected статический

_base( )

Возвращает базовый URL и устанавливает правильную директорию webroot

Если CakePHP вызывается с index.php в URL, даже если перенаправление URL активировано (и, следовательно, не требуется), оно поглощает ненужную часть из $base, чтобы предотвратить проблему #3318.

Возвращает

массив
Базовый URL, директория webroot, заканчивающаяся на /

_environmentDetector()source protected

_environmentDetector( array $detect )

Определяет, присутствует ли определённая переменная окружения.

Параметры

массив $detect

Массив параметров детектора.

Возвращает

булево
Является ли запрос нужного типа.

_headerDetector()source protected

_headerDetector( array $detect )

Определяет, присутствует ли определённый заголовок.

Параметры

массив $detect

Массив параметров детектора.

Возвращает

булево
Является ли запрос нужного типа.

_is()source protected

_is( string|array $type , array $args )

Функция для публичного is() метода

Параметры

строка|массив $type

Тип запроса, который нужно проверить. Если массив, этот метод вернёт true, если запрос соответствует любому типу.

массив $args

Массив пользовательских аргументов детектора.

Возвращает

булево
Является ли запрос нужного типа.

_paramDetector()source protected

_paramDetector( array $detect )

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

Параметры

массив $detect

Массив параметров детектора.

Возвращает

булево
Является ли запрос нужного типа.

_parseAcceptWithQualifier()source protected

_parseAcceptWithQualifier( string $header )

Обрабатывает заголовки Accept* с параметрами квалификатора.

Извлекаются только квалификаторы, любые другие расширения accept будут отброшены, так как они редко используются.

Параметры

строка $header

Заголовок для обработки.

Возвращает

массив

_processFileData()source protected

_processFileData( array $data , array $post , string $path '' , string $field '' )

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

Параметры

массив $data

Обрабатываемые данные

массив $post

Данные POST, по которым происходит итерация

строка $path необязательно ''

Путь с точками для вставки $data.

строка $field необязательно ''

Конечное поле в пути. Это одна из свойств $_FILES, например, name, tmp_name, size, error

Возвращает

массив
Перестроенные данные FILES

_processFiles()source protected

_processFiles( array $post , array $files )

Обрабатывает загруженные файлы и перемещает их в данные POST.

Параметры

массив $post

Данные POST, к которым нужно добавить файлы.

массив $files

Загруженные файлы для добавления.

Возвращает

массив
Объединённые данные POST + файлы.

_processGet()source protected

_processGet( array $query )

Обрабатывает параметры GET и перемещает их в объект.

Параметры

массив $query

Массив, в который добавляются обработанные ключи/значения.

Возвращает

массив
Массив, содержащий обработанные ключи/значения строки запроса.

_processPost()source protected

_processPost( array $data )

Устанавливает переменную среды REQUEST_METHOD на основе значения _method HTTP, используемого для имитации. Также сохраняется 'ORIGINAL_REQUEST_METHOD' Если вам нужно прочитать исходный HTTP-метод, использованный клиентом.

Параметры

массив $data

Массив данных POST.

Возвращает

массив

_readInput()source protected

_readInput( )

Считывает данные из php://input, имитируется в тестах.

Возвращает

строка
Содержимое php://input

_setConfig()source protected

_setConfig( array $config )

Обрабатывает конфигурационные данные в свойства.

Параметры

массив $config

Конфигурационные данные для использования.

_url()source protected static

_url( array $config )

Получить URI запроса. Сначала проверяется PATH_INFO, так как это точное значение, подготовленное PHP. После этого проверяются REQUEST_URI, PHP_SELF, HTTP_X_REWRITE_URL и argv в этом порядке. Каждая из этих переменных сервера имеет базовый путь и удалены строки запроса.

Параметры

массив $config

Конфигурация для настройки.

Возвращает

строка
Путь запроса CakePHP, к которому осуществляется доступ.

acceptLanguage()source public

acceptLanguage( string|null $language null )

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

Получить список принятых языков:

\Cake\Network\Request::acceptLanguage(); ```

Check if a specific language is accepted:

\Cake\Network\Request::acceptLanguage('es-es'); ```

Параметры

строка|null $language необязательно null

Язык для проверки.

Возвращает

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

accepts()source public

accepts( string|null $type null )

Определить, какие типы содержимого принимает клиент, или проверить, принимает ли он определённый тип содержимого.

Получить все типы:

$this->request->accepts();

Проверить один тип:

$this->request->accepts('application/json');

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

Параметры

строка|null $type необязательно null

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

Возвращает

массив|логическое значение

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

addDetector()source public static

addDetector( string $name , callable|array $callable )

Добавить новый детектор в список детекторов, которые может использовать запрос. Существуют различные форматы и типы детекторов, которые можно установить.

Детекторы обратного вызова

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

addDetector('custom', function ($request) { //Return a boolean });
addDetector('custom', ['SomeClass', 'somemethod']);

Сравнение значений среды

Сравнение значений среды сравнивает значение, извлеченное из env() со значением, установленным в среде.

Например, addDetector('post', ['env' => 'REQUEST_METHOD', 'value' => 'POST'])

Сравнение значений по шаблону

Сравнение значений по шаблону позволяет сравнить значение, извлеченное из env() с регулярным выражением.

addDetector('iphone', ['env' => 'HTTP_USER_AGENT', 'pattern' => '/iPhone/i']);

Сравнение на основе опций

Сравнения на основе опций используют список опций для создания регулярного выражения. Последующие вызовы по добавлению уже определённого детектора опций объединят опции.

addDetector('mobile', ['env' => 'HTTP_USER_AGENT', 'options' => ['Fennec']]);

Детекторы параметров запроса

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

Например, addDetector('requested', ['param' => 'requested', 'value' => 1]

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

addDetector('extension', ['param' => 'ext', 'options' => ['pdf', 'csv']]

Параметры

строка $name

Имя детектора.

вызываемый объект|массив $callable

Вызываемый объект или массив опций для определения детектора.

addParams()source public

addParams( array $params )

Добавить параметры к набору параметров запроса. Это перепишет любые существующие параметры. Изменяет параметры, доступные через $request->params.

Параметры

массив $params

Массив параметров для слияния.

Возвращает

$this Текущий объект, вы можете использовать цепочку методов.

addPaths()source public

addPaths( array $paths )

Добавить пути к переменным путей запроса. Перезапишет любые существующие пути. Предоставляет простой способ изменения webroot и base.

Параметры

массив $paths

Массив путей для слияния.

Возвращает

$this Текущий объект, вы можете использовать цепочку методов.

allowMethod()source public

allowMethod( string|array $methods )

Разрешить только определённые методы HTTP-запроса, если метод запроса не соответствует, будет показана ошибка 405, и будет установлен необходимый заголовок ответа «Allow».

Пример:

$this->request->allowMethod('post'); или $this->request->allowMethod(['post', 'delete']);

Если запрос будет GET, заголовок ответа «Allow: POST, DELETE» будет установлен, и будет возвращена ошибка 405.

Параметры

строка|массив $methods

Разрешённые методы HTTP-запроса.

Возвращает

логическое значение
true

Исключения

Cake\Network\Exception\MethodNotAllowedException

clearDetectorCache()source public

clearDetectorCache( )

Очистить кэш детектора экземпляра, используемый функцией is()

clientIp()source public

clientIp( )

Получить IP-адрес клиента или адрес, который он указал.

Возвращает

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

contentType()source public

contentType( )

Получить тип содержимого, используемый в этом запросе.

Возвращает

строка

cookie()source public

cookie( string $key )

Считывание данных cookie из данных cookie запроса.

Параметры

строка $key

Ключ для чтения.

Возвращает

null|строка
Значение cookie или null, если значение отсутствует.

createFromGlobals()source public static

createFromGlobals( )

Метод-обёртка для создания нового запроса из суперглобальных переменных PHP.

Использует данные $_GET, $_POST, $_FILES, $_COOKIE, $_SERVER, $_ENV и php://input для построения запроса.

Возвращает

Cake\Network\Request

data()source public

data( string|null $name null )

Предоставляет доступ для чтения/записи к $this->data. Позволяет использовать синтаксис, аналогичный синтаксису Cake\Model\Datasource\Session для чтения данных POST.

Чтение значений

$request->data('Post.title');

При чтении значений вы получите null для ключей/значений, которых нет.

Запись значений

$request->data('Post.title', 'New post!');

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

Параметры

строка|null $name необязательно null

Разделенный точкой имя значения для чтения/записи.

Возвращает

смешанный тип|Cake\Network\Request
$this Либо считанное значение, либо этот объект, чтобы вы могли выполнить последовательные записи.

domain()source public

domain( integer $tldLength 1 )

Получить доменное имя, включая сегменты $tldLength доменной зоны.

Параметры

целое число $tldLength необязательно 1

Количество сегментов, содержащихся в доменной зоне. Например: example.com содержит 1 доменную зону, а example.co.uk содержит 2.

Возвращает

строка
Доменное имя без поддоменов.

env()source public

env( string $key , string|null $value null , string|null $default null )

Получить/установить значение из данных среды запроса. Использовать env(), если ключ не задан в свойстве $environment.

Параметры

строка $key

Ключ, который нужно прочитать/записать.

строка|null $value необязательно null

Значение для установки. По умолчанию null.

строка|null $default необязательно null

Значение по умолчанию при попытке получить значение переменной окружения, которая не существует. Параметр value должен быть null.

Возвращает

$this|строка|null Этот экземпляр, если используется в качестве установщика, если используется в качестве получателя, либо значение среды, либо null, если значение не существует.

header()source public

header( string $name )

Считывание HTTP-заголовка из информации запроса.

Параметры

строка $name

Имя заголовка, который нужно получить.

Возвращает

строка|null
Либо null, если заголовок не задан, либо значение заголовка.

here()source public

here( boolean $base true )

Получить значение текущего URL-адреса запроса. Будет включать аргументы запроса.

Параметры

boolean $base необязательно true

Включить базовый путь, установить в false для удаления базового пути.

Возвращает

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

host()source public

host( )

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

Возвращает

строка

input()source public

input( string|null $callback null )

Считывание данных из php://input. Полезно при работе с содержанием тела запроса XML или JSON.

Получение ввода с функцией декодирования:

$this->request->input('json_decode');

Получение ввода с использованием функции декодирования и дополнительных параметров:

$this->request->input('Xml::build', ['return' => 'DOMDocument']);

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

Параметры

строка|null $callback необязательно null

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

Возвращает

строка
Декодированные/обработанные данные запроса.

is()source public

is( string|array $type )

Проверка типа запроса.

Использует встроенные правила определения, а также дополнительные правила, определенные с помощью Cake\Network\CakeRequest::addDetector(). Любой детектор можно вызывать как is($type) или is$Type().

Параметры

строка|массив $type

Тип запроса для проверки. Если массив, этот метод вернет true, если запрос соответствует любому типу.

Возвращает

булево
Результат проверки типа запроса.

isAll()source public

isAll( array $types )

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

Позволяет тестировать несколько типов и объединять результаты. См. Request::is() для добавления дополнительных типов и встроенных типов.

Параметры

массив $types

Типы для проверки.

Возвращает

булево
Результат проверки.

См. также

\Cake\Network\Request::is()

method()source public

method( )

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

• Если ваш клиент поддерживает, можно использовать нативные HTTP-методы.
• Можно установить заголовок HTTP-X-Method-Override.
• Можно отправить входной элемент с именем _method

Любой из этих 3 подходов можно использовать для установки HTTP-метода, используемого CakePHP внутренне, и это повлияет на результат этого метода.

Возвращает

строка
Название используемого HTTP-метода.

offsetExists()source public

offsetExists( string $name )

Реализация isset() для доступа к массивам.

Параметры

строка $name

Элемент для проверки.

Возвращает

булево

Реализация

ArrayAccess::offsetExists()

offsetGet()source public

offsetGet( string $name )

Реализация чтения для доступа к массивам.

Параметры

строка $name

Имя ключа, к которому осуществляется доступ.

Возвращает

смешанное

Реализация

ArrayAccess::offsetGet()

offsetSet()source public

offsetSet( string $name , mixed $value )

Реализация записи для доступа к массивам.

Параметры

строка $name

Имя ключа, к которому осуществляется запись.

смешанное $value

Записываемое значение.

Реализация

ArrayAccess::offsetSet()

offsetUnset()source public

offsetUnset( string $name )

Реализация удаления для доступа к массивам.

Параметры

строка $name

Имя для удаления.

Реализация

ArrayAccess::offsetUnset()

param()source public

param( string $name )

Безопасный доступ к значениям в $this->params.

Параметры

строка $name

Имя параметра для получения.

Возвращает

смешанное|Cake\Network\Request

$this Значение предоставленного параметра. Вернёт false, если параметр не существует или является ложным.

parseAccept()source public

parseAccept( )

Разбор заголовка HTTP_ACCEPT и возврат отсортированного массива с типами контента в качестве ключей и значениями pref.

В общем случае вы хотите использовать Cake\Network\Request::accept() для получения простого списка поддерживаемых типов контента.

Возвращает

массив
Массив prefValue => [типов контента]

port()source public

port( )

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

Возвращает

строка

query()source public

query( string $name )

Обеспечивает доступ для чтения к $this->query. Позволяет использовать синтаксис, похожий на CakeSession для чтения данных запроса URL.

Параметры

строка $name

Имя переменной строки запроса

Возвращает

смешанное
Считываемое значение

referer()source public

referer( boolean $local false )

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

Параметры

boolean $local необязательно false

Попытка вернуть локальный адрес. Локальные адреса не содержат имен хостов.

Возвращает

строка
Адрес, ссылающийся на этот запрос.

scheme()source public

scheme( )

Получить текущий используемый в запросе схему URL.

Например, 'http' или 'https'

Возвращает

строка
Используемая в запросе схема.

session()source public

session( Cake\Network\Session $session null )

Возвращает экземпляр объекта Session для данного запроса

Если объект сессии передан в качестве первого аргумента, он будет установлен в качестве сессии для использования в этом запросе

Параметры

Cake\Network\Session $session необязательно null

объект сессии для использования

Возвращает

Cake\Network\Session

setInput()source public

setInput( string $input )

Изменяет данные, изначально полученные из php://input. Полезно для изменения данных json/xml в middleware или DispatcherFilters до их попадания в RequestHandlerComponent

Параметры

строка $input

Строка, заменяющая исходные обработанные данные из input()

subdomains()source public

subdomains( integer $tldLength 1 )

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

Параметры

целое число $tldLength необязательно 1

Количество сегментов, которые содержит ваша зона верхнего уровня доменных имён (TLD). Например: example.com содержит 1 TLD. В то время как example.co.uk содержит 2.

Возвращает

массив
Массив поддоменов.

[]

[
    'get' => ['env' => 'REQUEST_METHOD', 'value' => 'GET'],
    'post' => ['env' => 'REQUEST_METHOD', 'value' => 'POST'],
    'put' => ['env' => 'REQUEST_METHOD', 'value' => 'PUT'],
    'patch' => ['env' => 'REQUEST_METHOD', 'value' => 'PATCH'],
    'delete' => ['env' => 'REQUEST_METHOD', 'value' => 'DELETE'],
    'head' => ['env' => 'REQUEST_METHOD', 'value' => 'HEAD'],
    'options' => ['env' => 'REQUEST_METHOD', 'value' => 'OPTIONS'],
    'ssl' => ['env' => 'HTTPS', 'options' => [1, 'on']],
    'ajax' => ['env' => 'HTTP_X_REQUESTED_WITH', 'value' => 'XMLHttpRequest'],
    'flash' => ['env' => 'HTTP_USER_AGENT', 'pattern' => '/^(Shockwave|Adobe) Flash/'],
    'requested' => ['param' => 'requested', 'value' => 1],
    'json' => ['accept' => ['application/json'], 'param' => '_ext', 'value' => 'json'],
    'xml' => ['accept' => ['application/xml', 'text/xml'], 'param' => '_ext', 'value' => 'xml'],
]

[]

''

[]

[]

[
    'plugin' => null,
    'controller' => null,
    'action' => null,
    '_ext' => null,
    'pass' => []
]

[]

false

'/'