Inheritance | yii\httpclient\Request » yii\httpclient\Message » yii\base\Component » yii\base\Object |
---|---|
Implements | yii\base\Configurable |
Available since version | 2.0 |
Source Code | https://github.com/yiisoft/yii2-httpclient/blob/master/Request.php |
Request represents HTTP request.
Property | Type | Description | Defined By |
---|---|---|---|
$behaviors | yii\base\Behavior[] | List of behaviors attached to this component | yii\base\Component |
$client | yii\httpclient\Client | Owner client instance. | yii\httpclient\Message |
$content | string | Raw content. | yii\httpclient\Message |
$cookies | yii\web\CookieCollection|yii\web\Cookie[]|array | Cookie collection or cookies list. | yii\httpclient\Message |
$data | mixed | Content data fields. | yii\httpclient\Request |
$format | string | Body format name. | yii\httpclient\Message |
$fullUrl | string | Full target URL. | yii\httpclient\Request |
$headers | array|yii\web\HeaderCollection | Headers collection or headers list in format: [headerName => headerValue] | yii\httpclient\Message |
$method | string | Request method | yii\httpclient\Request |
$options | array | Request options. | yii\httpclient\Request |
$url | string|array | Use a string to represent a URL (e.g. `http://some-domain. | yii\httpclient\Request |
Method | Description | Defined By |
---|---|---|
__call() | Calls the named method which is not a class method. | yii\base\Component |
__clone() | This method is called after the object is created by cloning an existing one. | yii\base\Component |
__construct() | Constructor. | yii\base\Object |
__get() | Returns the value of a component property. | yii\base\Component |
__isset() | Checks if a property is set, i.e. defined and not null. | yii\base\Component |
__set() | Sets the value of a component property. | yii\base\Component |
__toString() | PHP magic method that returns the string representation of this object. | yii\httpclient\Message |
__unset() | Sets a component property to be null. | yii\base\Component |
addContent() | Adds a content part for multi-part content request. | yii\httpclient\Request |
addCookies() | Adds more cookies to the already defined ones. | yii\httpclient\Message |
addData() | Adds data fields to the existing ones. | yii\httpclient\Request |
addFile() | Adds a file for upload as multi-part content. | yii\httpclient\Request |
addFileContent() | Adds a string as a file upload. | yii\httpclient\Request |
addHeaders() | Adds more headers to the already defined ones. | yii\httpclient\Message |
addOptions() | Adds more options to already defined ones. | yii\httpclient\Request |
afterSend() | This method is invoked right after this request is sent. | yii\httpclient\Request |
attachBehavior() | Attaches a behavior to this component. | yii\base\Component |
attachBehaviors() | Attaches a list of behaviors to the component. | yii\base\Component |
beforeSend() | This method is invoked right before this request is sent. | yii\httpclient\Request |
behaviors() | Returns a list of behaviors that this component should behave as. | yii\base\Component |
canGetProperty() | Returns a value indicating whether a property can be read. | yii\base\Component |
canSetProperty() | Returns a value indicating whether a property can be set. | yii\base\Component |
className() | Returns the fully qualified name of this class. | yii\base\Object |
composeHeaderLines() | Composes raw header lines from $headers. | yii\httpclient\Request |
detachBehavior() | Detaches a behavior from the component. | yii\base\Component |
detachBehaviors() | Detaches all behaviors from the component. | yii\base\Component |
ensureBehaviors() | Makes sure that the behaviors declared in behaviors() are attached to this component. | yii\base\Component |
getBehavior() | Returns the named behavior object. | yii\base\Component |
getBehaviors() | Returns all behaviors attached to this component. | yii\base\Component |
getContent() | Returns HTTP message raw content. | yii\httpclient\Message |
getCookies() | Returns the cookie collection. | yii\httpclient\Message |
getData() | Returns the data fields, parsed from raw content. | yii\httpclient\Message |
getFormat() | Returns body format. | yii\httpclient\Message |
getFullUrl() | Returns full target URL, including yii\httpclient\Client::$baseUrl as a string. | yii\httpclient\Request |
getHeaders() | Returns the header collection. | yii\httpclient\Message |
getMethod() | yii\httpclient\Request | |
getOptions() | yii\httpclient\Request | |
getUrl() | Returns target URL. | yii\httpclient\Request |
hasCookies() | Checks of HTTP message contains any cookie. | yii\httpclient\Message |
hasEventHandlers() | Returns a value indicating whether there is any handler attached to the named event. | yii\base\Component |
hasHeaders() | Checks of HTTP message contains any header. | yii\httpclient\Message |
hasMethod() | Returns a value indicating whether a method is defined. | yii\base\Component |
hasProperty() | Returns a value indicating whether a property is defined for this component. | yii\base\Component |
init() | Initializes the object. | yii\base\Object |
off() | Detaches an existing event handler from this component. | yii\base\Component |
on() | Attaches an event handler to an event. | yii\base\Component |
prepare() | Prepares this request instance for sending. | yii\httpclient\Request |
send() | Sends this request. | yii\httpclient\Request |
setContent() | Sets the HTTP message raw content. | yii\httpclient\Message |
setCookies() | Sets the cookies associated with HTTP message. | yii\httpclient\Message |
setData() | Sets the data fields, which composes message content. | yii\httpclient\Request |
setFormat() | Sets body format. | yii\httpclient\Message |
setFullUrl() | Sets full target URL. | yii\httpclient\Request |
setHeaders() | Sets the HTTP headers associated with HTTP message. | yii\httpclient\Message |
setMethod() | yii\httpclient\Request | |
setOptions() | Following options are supported: - timeout: int, the maximum number of seconds to allow request to be executed. | yii\httpclient\Request |
setUrl() | Sets target URL. | yii\httpclient\Request |
toString() | Returns string representation of this HTTP message. | yii\httpclient\Request |
trigger() | Triggers an event. | yii\base\Component |
Method | Description | Defined By |
---|---|---|
defaultFormat() | Returns default format name. | yii\httpclient\Message |
Event | Type | Description | Defined By |
---|---|---|---|
EVENT_AFTER_SEND | yii\httpclient\RequestEvent | An event raised right after request has been sent. | yii\httpclient\Request |
EVENT_BEFORE_SEND | yii\httpclient\RequestEvent | An event raised right before sending request. | yii\httpclient\Request |
Content data fields.
public mixed getData ( )
public $this setData ( $data )
Full target URL.
public string getFullUrl ( )
public void setFullUrl ( $fullUrl )
Request method
public string getMethod ( )
public $this setMethod ( $method )
Request options.
public array getOptions ( )
public $this setOptions ( array $options )
Use a string to represent a URL (e.g. http://some-domain.com
, item/list
), or an array to represent a URL with query parameters (e.g. ['item/list', 'param1' => 'value1']
).
public string|array getUrl ( )
public $this setUrl ( $url )
Adds a content part for multi-part content request.
public $this addContent ( $name, $content, $options = [] ) | ||
---|---|---|
$name | string |
Part (form input) name. |
$content | string |
Content. |
$options | array |
Content part options, valid options are:
|
return | $this |
Self reference. |
Adds data fields to the existing ones.
public $this addData ( $data ) | ||
---|---|---|
$data | array |
Additional content data fields. |
return | $this |
Self reference. |
Adds a file for upload as multi-part content.
See also addContent().
public $this addFile ( $name, $fileName, $options = [] ) | ||
---|---|---|
$name | string |
Part (form input) name |
$fileName | string |
Full name of the source file. |
$options | array |
Content part options, valid options are:
|
Adds a string as a file upload.
See also addContent().
public $this addFileContent ( $name, $content, $options = [] ) | ||
---|---|---|
$name | string |
Part (form input) name |
$content | string |
File content. |
$options | array |
Content part options, valid options are:
|
Adds more options to already defined ones.
Please refer to setOptions() on how to specify options.
public $this addOptions ( array $options ) | ||
---|---|---|
$options | array |
Additional options |
return | $this |
Self reference. |
This method is invoked right after this request is sent.
The method will invoke yii\httpclient\Client::afterSend() and trigger the EVENT_AFTER_SEND event.
public void afterSend ( $response ) | ||
---|---|---|
$response | yii\httpclient\Response |
Received response instance. |
This method is invoked right before this request is sent.
The method will invoke yii\httpclient\Client::beforeSend() and trigger the EVENT_BEFORE_SEND event.
public void beforeSend ( ) |
---|
Composes raw header lines from $headers.
Each line will be a string in format: 'header-name: value'.
public array composeHeaderLines ( ) | ||
---|---|---|
return | array |
Raw header lines. |
Returns full target URL, including yii\httpclient\Client::$baseUrl as a string.
public string getFullUrl ( ) | ||
---|---|---|
return | string |
Full target URL. |
public string getMethod ( ) | ||
---|---|---|
return | string |
Request method |
public array getOptions ( ) | ||
---|---|---|
return | array |
Request options. |
Returns target URL.
public string|array getUrl ( ) | ||
---|---|---|
return | string|array |
Target URL or URL parameters |
Prepares this request instance for sending.
This method should be invoked by transport before sending a request. Do not call this method unless you know what you are doing.
public $this prepare ( ) | ||
---|---|---|
return | $this |
Self reference. |
Sends this request.
public yii\httpclient\Response send ( ) | ||
---|---|---|
return | yii\httpclient\Response |
Response instance. |
Sets the data fields, which composes message content.
public $this setData ( $data ) | ||
---|---|---|
$data | mixed |
Content data fields. |
return | $this |
Self reference. |
Sets full target URL.
This method can be use during request formatting and preparation. Do not use it for the target URL specification, use setUrl() instead.
public void setFullUrl ( $fullUrl ) | ||
---|---|---|
$fullUrl | string |
Full target URL. |
public $this setMethod ( $method ) | ||
---|---|---|
$method | string |
Request method |
return | $this |
Self reference. |
Following options are supported: - timeout: int, the maximum number of seconds to allow request to be executed.
You may set options using keys, which are specific to particular transport, like [CURLOPT_VERBOSE => true]
in case there is a necessity for it.
public $this setOptions ( array $options ) | ||
---|---|---|
$options | array |
Request options. |
return | $this |
Self reference. |
Sets target URL.
public $this setUrl ( $url ) | ||
---|---|---|
$url | string|array |
Use a string to represent a URL (e.g. |
return | $this |
Self reference. |
Returns string representation of this HTTP message.
public string toString ( ) | ||
---|---|---|
return | string |
The string representation of this HTTP message. |
An event raised right after request has been sent.
An event raised right before sending request.
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-httpclient-request.html