Class Request
Implements methods for HTTP requests.
Used by Cake\Network\Http\Client to contain request information for making requests.
- Cake\Network\Http\Message
-
Cake\Network\Http\Request
Inherited Constants
-
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_OK,STATUS_SEE_OTHER,STATUS_TEMPORARY_REDIRECT
Properties summary
-
$_bodyprotectedRequest body to send.mixed -
$_headersprotectedHeaders to be sent.array -
$_methodprotectedThe HTTP method to use.string -
$_urlprotectedThe URL to request.string
Inherited Properties
Method Summary
- cookie() publicGet/Set cookie values.
- header() publicGet/Set headers into the request.
- method() publicGet/Set the HTTP method.
- url() publicGet/Set the url for the request.
- version() publicGet/Set HTTP version.
Method Detail
cookie()source public
cookie( string $name , string|null $value null )
Get/Set cookie values.
Getting a cookie
$request->cookie('session'); Setting one cookie
$request->cookie('session', '123456'); Setting multiple headers
$request->cookie(['test' => 'value', 'split' => 'banana']);
Parameters
- string
$name - The name of the cookie to get/set
- string|null
$valueoptional null - Either the value or null when getting values.
Returns
mixedEither $this or the cookie value.
header()source public
header( string|array|null $name null , string|null $value null )
Get/Set headers into the request.
You can get the value of a header, or set one/many headers. Headers are set / fetched in a case insensitive way.
Getting headers
$request->header('Content-Type'); Setting one header
$request->header('Content-Type', 'application/json'); Setting multiple headers
$request->header(['Connection' => 'close', 'User-Agent' => 'CakePHP']);
Parameters
- string|array|null
$nameoptional null - The name to get, or array of multiple values to set.
- string|null
$valueoptional null - The value to set for the header.
Returns
mixedEither $this when setting or header value when getting.
method()source public
method( string|null $method null )
Get/Set the HTTP method.
Parameters
- string|null
$methodoptional null - The method for the request.
Returns
$this|string Either this or the current method.
Throws
Cake\Core\Exception\ExceptionOn invalid methods.
url()source public
url( string|null $url null )
Get/Set the url for the request.
Parameters
- string|null
$urloptional null - The url for the request. Leave null for get
Returns
$this|string Either $this or the url value.
version()source public
version( string|null $version null )
Get/Set HTTP version.
Parameters
- string|null
$versionoptional null - The HTTP version.
Returns
$this|string Either $this or the HTTP version.
Overrides
Cake\Network\Http\Message::version() Methods inherited from Cake\Network\Http\Message
_normalizeHeader()source protected
_normalizeHeader( string $name )
Normalize header names to Camel-Case form.
Parameters
- string
$name - The header name to normalize.
Returns
stringNormalized header name.
body()source public
body( string|null $body null )
Get/set the body for the message.
Parameters
- string|null
$bodyoptional null - The body for the request. Leave null for get
Returns
mixedEither $this or the body value.
Properties detail
$_headerssource
protected array
Headers to be sent.
[
'Connection' => 'close',
'User-Agent' => 'CakePHP'
]
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Network.Http.Request.html