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
-
$_body
protectedRequest body to send.mixed
-
$_headers
protectedHeaders to be sent.array
-
$_method
protectedThe HTTP method to use.string
-
$_url
protectedThe 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
$value
optional 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
$name
optional null - The name to get, or array of multiple values to set.
- string|null
$value
optional 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
$method
optional null - The method for the request.
Returns
$this|string Either this or the current method.
Throws
Cake\Core\Exception\Exception
On invalid methods.
url()source public
url( string|null $url null )
Get/Set the url for the request.
Parameters
- string|null
$url
optional 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
$version
optional 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
$body
optional 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