Класс Request
Реализует методы для HTTP-запросов.
Используется в Cake\Http\Client для хранения информации о запросе при выполнении запросов.
- Cake\Http\Client\Message
-
Cake\Http\Client\Request реализует Psr\Http\Message\RequestInterface использует Zend\Diactoros\RequestTrait
Наследованные константы
-
METHOD_DELETE,METHOD_GET,METHOD_HEAD,METHOD_OPTIONS,METHOD_PATCH,METHOD_POST,METHOD_PUT,METHOD_TRACE,STATUS_ACCEPTED,STATUS_CREATED,STATUS_FOUND,STATUS_MOVED_PERMANENTLY,STATUS_NON_AUTHORITATIVE_INFORMATION,STATUS_NO_CONTENT,STATUS_OK,STATUS_SEE_OTHER,STATUS_TEMPORARY_REDIRECT
Наследованные магические свойства
Наследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- addHeaders() protectedДобавить массив заголовков к запросу.
- body() publicПолучить/установить тело/загрузку для сообщения.
- cookie() publicПолучить/установить значения cookie.
- header() publicПолучить/установить заголовки в запросе.
- method() publicПолучить/установить HTTP-метод.
- url() publicПолучить/установить URL для запроса.
- version() publicПолучить/установить версию HTTP.
Подробное описание методов
__construct()source public
__construct( string $url '' , string $method self::METHOD_GET , array $headers [] , array|string|null $data null )
Конструктор
Обеспечивает обратную совместимость со значениями по умолчанию для некоторых свойств.
Параметры
- строка
$urlнеобязательный '' - URL запроса
- строка
$methodнеобязательный self::METHOD_GET - HTTP-метод, который следует использовать.
- массив
$headersнеобязательный [] - HTTP-заголовки для установки.
- массив|строка|null
$dataнеобязательный null - Тело запроса для использования.
addHeaders()source protected
addHeaders( array $headers )
Добавить массив заголовков к запросу.
Параметры
- массив
$headers - Заголовки для добавления.
body()source public
body( string|array|null $body null )
Получить/установить тело/загрузку для сообщения.
Данные массива будут сериализованы с помощью Cake\Http\FormData, и тип содержимого будет установлен.
Параметры
- строка|массив|null
$bodyнеобязательный null - Тело запроса. Оставить null для получения
Возвращает
смешанный типЛибо $this, либо значение тела.
Переопределяет
Cake\Http\Client\Message::body() cookie()source public
cookie( string $name , string|null $value null )
Получить/установить значения cookie.
Получение cookie
$request->cookie('session'); Установка одной cookie
$request->cookie('session', '123456'); Установка нескольких заголовков
$request->cookie(['test' => 'value', 'split' => 'banana']);
Устаревший
3.5.0 Больше не используется. CookieCollections теперь добавляют Cookie заголовок в запрос перед отправкой. Используйте Cake\Http\Cookie\CookieCollection::addToRequest(), чтобы облегчить добавление cookie в запрос.
Параметры
- строка
$name - Имя cookie для получения/установки
- строка|null
$valueнеобязательный null - Значение или null при получении значений.
Возвращает
смешанный типЛибо $this, либо значение cookie.
header()source public
header( string|array|null $name null , string|null $value null )
Получить/установить заголовки в запросе.
Вы можете получить значение заголовка или установить один/несколько заголовков. Заголовки устанавливаются/получаются без учёта регистра.
Получение заголовков
$request->header('Content-Type'); Установка одного заголовка
$request->header('Content-Type', 'application/json'); Установка нескольких заголовков
$request->header(['Connection' => 'close', 'User-Agent' => 'CakePHP']);
Предупреждение Этот метод изменяет запрос на месте по соображениям обратной совместимости и не является частью интерфейса PSR7.
Устаревший
3.3.0 Используйте withHeader() и getHeaderLine() вместо этого.Параметры
- строка|массив|null
$nameнеобязательный null - Имя для получения или массив нескольких значений для установки.
- строка|null
$valueнеобязательный null - Значение для установки заголовка.
Возвращает
смешанный тип$this при установке или значение заголовка при получении.
method()source public
method( string|null $method null )
Получить/установить HTTP-метод.
Предупреждение Этот метод изменяет запрос на месте по соображениям обратной совместимости и не является частью интерфейса PSR7.
Устаревший
3.3.0 Используйте getMethod() и withMethod() вместо этого.Параметры
- строка|null
$methodнеобязательный null - Метод для запроса.
Возвращает
$this|строка Либо этот объект, либо текущий метод.
Исключение
Cake\Core\Exception\ExceptionПри неверных методах.
url()source public
url( string|null $url null )
Получить/установить URL для запроса.
Предупреждение Этот метод изменяет запрос на месте по соображениям обратной совместимости и не является частью интерфейса PSR7.
Устаревший
3.3.0 Используйте getUri() и withUri() вместо этого.Параметры
- строка|null
$urlнеобязательный null - URL запроса. Оставить null для получения
Возвращает
$this|строка Либо $this, либо значение URL.
version()source public
version( string|null $version null )
Получить/установить версию HTTP.
Предупреждение Этот метод изменяет запрос на месте по соображениям обратной совместимости и не является частью интерфейса PSR7.
Устаревший
3.3.0 Используйте getProtocolVersion() и withProtocolVersion() вместо этого.Параметры
- строка|null
$versionнеобязательный null - Версия HTTP.
Возвращает
$this|строка Либо $this, либо версия HTTP.
Наследованные методы из Cake\Http\Client\Message
headers()source public
headers( )
Получить все заголовки
Устаревший
3.3.0 Используйте getHeaders() вместо этого.Возвращает
массив
© 2005–2018 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.5/class-Cake.Http.Client.Request.html