Class Request

HTTP request class to send requests

Guzzle\Http\Message\AbstractMessage implements Guzzle\Http\Message\MessageInterface

Guzzle\Http\Message\Request implements Guzzle\Http\Message\RequestInterface

Direct known subclasses

Guzzle\Http\Message\EntityEnclosingRequest

Namespace: Guzzle\Http\Message
Located at Guzzle/Http/Message/Request.php

Methods summary
`public static array`	# `getAllEvents( )` Get a list of all of the events emitted from the class Get a list of all of the events emitted from the class Returns `array` Implementation of `Guzzle\Common\HasDispatcherInterface::getAllEvents()`
`public`	# `__construct( string $method, string\|Guzzle\Http\Url $url, array\|Guzzle\Common\Collection $headers = array() )` Create a new request Create a new request Parameters `$method` `string` $method HTTP method `$url` `string\|Guzzle\Http\Url` $url HTTP URL to connect to. The URI scheme, host header, and URI are parsed from the full URL. If query string parameters are present they will be parsed as well. `$headers` `array\|Guzzle\Common\Collection` $headers HTTP headers
`public`	# `__clone( )` Clone the request object, leaving off any response that was received Clone the request object, leaving off any response that was received See Guzzle\Plugin\Redirect\RedirectPlugin::cloneRequestWithGetMethod
`public string`	# `__toString( )` Get the HTTP request as a string Get the HTTP request as a string Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::__toString()`
`public static`	# `onRequestError( Guzzle\Common\Event $event )` Default method that will throw exceptions if an unsuccessful response is received. Default method that will throw exceptions if an unsuccessful response is received. Parameters `$event` `Guzzle\Common\Event` $event Received Throws `Guzzle\Http\Exception\BadResponseException` if the response is not successful
`public Guzzle\Http\Message\RequestInterface`	# `setClient( Guzzle\Http\ClientInterface $client )` Set the client used to transport the request Set the client used to transport the request Parameters `$client` `Guzzle\Http\ClientInterface` $client Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setClient()`
`public Guzzle\Http\ClientInterface`	# `getClient( )` Get the client used to transport the request Get the client used to transport the request Returns `Guzzle\Http\ClientInterface` $client Implementation of `Guzzle\Http\Message\RequestInterface::getClient()`
`public string`	# `getRawHeaders( )` Get the raw message headers as a string Get the raw message headers as a string Returns `string` Implementation of `Guzzle\Http\Message\MessageInterface::getRawHeaders()`
`public Guzzle\Http\Message\RequestInterface`	# `setUrl( string $url )` Set the URL of the request Set the URL of the request Parameters `$url` `string` $url\|Url Full URL to set including query string Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setUrl()`
`public Guzzle\Http\Message\Response`	# `send( )` Send the request Send the request Returns `Guzzle\Http\Message\Response` Throws `Guzzle\Http\Exception\RequestException` on a request error Implementation of `Guzzle\Http\Message\RequestInterface::send()`
`public Guzzle\Http\Message\Response\|null`	# `getResponse( )` Get the previously received `Guzzle\Http\Message\Response` or NULL if the request has not been sent Get the previously received `Guzzle\Http\Message\Response` or NULL if the request has not been sent Returns `Guzzle\Http\Message\Response\|null` Implementation of `Guzzle\Http\Message\RequestInterface::getResponse()`
`public QueryString`	# `getQuery( mixed $asString = false )` Get the collection of key value pairs that will be used as the query string in the request Get the collection of key value pairs that will be used as the query string in the request Returns `QueryString` Implementation of `Guzzle\Http\Message\RequestInterface::getQuery()`
`public string`	# `getMethod( )` Get the HTTP method of the request Get the HTTP method of the request Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getMethod()`
`public string`	# `getScheme( )` Get the URI scheme of the request (http, https, ftp, etc) Get the URI scheme of the request (http, https, ftp, etc) Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getScheme()`
`public Guzzle\Http\Message\RequestInterface`	# `setScheme( string $scheme )` Set the URI scheme of the request (http, https, ftp, etc) Set the URI scheme of the request (http, https, ftp, etc) Parameters `$scheme` `string` $scheme Scheme to set Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setScheme()`
`public string`	# `getHost( )` Get the host of the request Get the host of the request Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getHost()`
`public Guzzle\Http\Message\RequestInterface`	# `setHost( string $host )` Set the host of the request. Including a port in the host will modify the port of the request. Set the host of the request. Including a port in the host will modify the port of the request. Parameters `$host` `string` $host Host to set (e.g. www.yahoo.com, www.yahoo.com:80) Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setHost()`
`public string`	# `getProtocolVersion( )` Get the HTTP protocol version of the request Get the HTTP protocol version of the request Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getProtocolVersion()`
`public Guzzle\Http\Message\RequestInterface`	# `setProtocolVersion( string $protocol )` Set the HTTP protocol version of the request (e.g. 1.1 or 1.0) Set the HTTP protocol version of the request (e.g. 1.1 or 1.0) Parameters `$protocol` `string` $protocol HTTP protocol version to use with the request Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setProtocolVersion()`
`public string`	# `getPath( )` Get the path of the request (e.g. '/', '/index.html') Get the path of the request (e.g. '/', '/index.html') Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getPath()`
`public Guzzle\Http\Message\RequestInterface`	# `setPath( string\|array $path )` Set the path of the request (e.g. '/', '/index.html') Set the path of the request (e.g. '/', '/index.html') Parameters `$path` `string\|array` $path Path to set or array of segments to implode Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setPath()`
`public integer\|null`	# `getPort( )` Get the port that the request will be sent on if it has been set Get the port that the request will be sent on if it has been set Returns `integer\|null` Implementation of `Guzzle\Http\Message\RequestInterface::getPort()`
`public Guzzle\Http\Message\RequestInterface`	# `setPort( integer $port )` Set the port that the request will be sent on Set the port that the request will be sent on Parameters `$port` `integer` $port Port number to set Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setPort()`
`public string\|null`	# `getUsername( )` Get the username to pass in the URL if set Get the username to pass in the URL if set Returns `string\|null` Implementation of `Guzzle\Http\Message\RequestInterface::getUsername()`
`public string\|null`	# `getPassword( )` Get the password to pass in the URL if set Get the password to pass in the URL if set Returns `string\|null` Implementation of `Guzzle\Http\Message\RequestInterface::getPassword()`
`public Guzzle\Http\Message\Request`	# `setAuth( string\|boolean $user, string $password = '', string $scheme = CURLAUTH_BASIC )` Set HTTP authorization parameters Set HTTP authorization parameters Parameters `$user` `string\|boolean` $user User name or false disable authentication `$password` `string` $password Password `$scheme` `string` $scheme Authentication scheme to use (CURLAUTH_BASIC, CURLAUTH_DIGEST, etc) Returns `Guzzle\Http\Message\Request` Throws `Guzzle\Http\Exception\RequestException` Implementation of `Guzzle\Http\Message\RequestInterface::setAuth()`
`public string`	# `getResource( )` Get the resource part of the the request, including the path, query string, and fragment Get the resource part of the the request, including the path, query string, and fragment Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getResource()`
`public string\|Guzzle\Http\Url`	# `getUrl( boolean $asObject = false )` Get the full URL of the request (e.g. 'http://www.guzzle-project.com/') scheme://username:password@domain:port/path?query_string#fragment Get the full URL of the request (e.g. 'http://www.guzzle-project.com/') scheme://username:password@domain:port/path?query_string#fragment Parameters `$asObject` `boolean` $asObject Set to TRUE to retrieve the URL as a clone of the URL object owned by the request. Returns `string\|Guzzle\Http\Url` Implementation of `Guzzle\Http\Message\RequestInterface::getUrl()`
`public string`	# `getState( )` Get the state of the request. One of 'complete', 'sending', 'new' Get the state of the request. One of 'complete', 'sending', 'new' Returns `string` Implementation of `Guzzle\Http\Message\RequestInterface::getState()`
`public Guzzle\Http\Message\RequestInterface`	# `setState( string $state, array $context = array() )` Set the state of the request Set the state of the request Parameters `$state` `string` $state State of the request (complete, sending, or new) `$context` `array` $context Contextual information about the state change Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::setState()`
`public Guzzle\Common\Collection`	# `getCurlOptions( )` Get the cURL options that will be applied when the cURL handle is created Get the cURL options that will be applied when the cURL handle is created Returns `Guzzle\Common\Collection` Implementation of `Guzzle\Http\Message\RequestInterface::getCurlOptions()`
`public integer`	# `receiveResponseHeader( string $data )` Method to receive HTTP response headers as they are retrieved Method to receive HTTP response headers as they are retrieved Parameters `$data` `string` $data Header data. Returns `integer` Returns the size of the data. Implementation of `Guzzle\Http\Message\RequestInterface::receiveResponseHeader()`
`public Guzzle\Http\Message\RequestInterface`	# `setResponse( Guzzle\Http\Message\Response $response, boolean $queued = false )` Manually set a response for the request. Manually set a response for the request. Parameters `$response` `Guzzle\Http\Message\Response` $response Response object to set `$queued` `boolean` $queued Set to TRUE to keep the request in a state of not having been sent, but queue the response for send() Returns `Guzzle\Http\Message\RequestInterface` Returns a reference to the object. Implementation of `Guzzle\Http\Message\RequestInterface::setResponse()`
`public Guzzle\Http\Message\Request`	# `setResponseBody( Guzzle\Http\EntityBodyInterface\|string\|resource $body )` Set the EntityBody that will hold a successful response message's entity body. Set the EntityBody that will hold a successful response message's entity body. Parameters `$body` `Guzzle\Http\EntityBodyInterface\|string\|resource` $body Response body object. Pass a string to attempt to store the response body in a local file. Returns `Guzzle\Http\Message\Request` Implementation of `Guzzle\Http\Message\RequestInterface::setResponseBody()`
`public Guzzle\Http\EntityBodyInterface`	# `getResponseBody( )` Get the EntityBody that will hold the resulting response message's entity body. This response body will only be used for successful responses. Intermediate responses (e.g. redirects) will not use the targeted response body. Get the EntityBody that will hold the resulting response message's entity body. This response body will only be used for successful responses. Intermediate responses (e.g. redirects) will not use the targeted response body. Returns `Guzzle\Http\EntityBodyInterface` Implementation of `Guzzle\Http\Message\RequestInterface::getResponseBody()`
`public boolean`	# `isResponseBodyRepeatable( )` Determine if the response body is repeatable (readable + seekable) Determine if the response body is repeatable (readable + seekable) Returns `boolean` Implementation of `Guzzle\Http\Message\RequestInterface::isResponseBodyRepeatable()`
`public array`	# `getCookies( )` Get an array of Cookies Get an array of Cookies Returns `array` Implementation of `Guzzle\Http\Message\RequestInterface::getCookies()`
`public null\|string`	# `getCookie( string $name )` Get a cookie value by name Get a cookie value by name Parameters `$name` `string` $name Cookie to retrieve Returns `null\|string` Implementation of `Guzzle\Http\Message\RequestInterface::getCookie()`
`public Guzzle\Http\Message\RequestInterface`	# `addCookie( string $name, string $value )` Add a Cookie value by name to the Cookie header Add a Cookie value by name to the Cookie header Parameters `$name` `string` $name Name of the cookie to add `$value` `string` $value Value to set Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::addCookie()`
`public Guzzle\Http\Message\RequestInterface`	# `removeCookie( string $name )` Remove a specific cookie value by name Remove a specific cookie value by name Parameters `$name` `string` $name Cookie to remove by name Returns `Guzzle\Http\Message\RequestInterface` Implementation of `Guzzle\Http\Message\RequestInterface::removeCookie()`
`public boolean`	# `canCache( )` Returns whether or not the request can be cached Returns whether or not the request can be cached Returns `boolean` Implementation of `Guzzle\Http\Message\RequestInterface::canCache()`
`public HasDispatcherInterface`	# `setEventDispatcher( Symfony\Component\EventDispatcher\EventDispatcherInterface $eventDispatcher )` Set the EventDispatcher of the request Set the EventDispatcher of the request Parameters `$eventDispatcher` `Symfony\Component\EventDispatcher\EventDispatcherInterface` $eventDispatcher Returns `HasDispatcherInterface` Implementation of `Guzzle\Common\HasDispatcherInterface::setEventDispatcher()`
`public Symfony\Component\EventDispatcher\EventDispatcherInterface`	# `getEventDispatcher( )` Get the EventDispatcher of the request Get the EventDispatcher of the request Returns `Symfony\Component\EventDispatcher\EventDispatcherInterface` Implementation of `Guzzle\Common\HasDispatcherInterface::getEventDispatcher()`
`public`	# `dispatch( string $eventName, array $context = array() )` Helper to dispatch Guzzle events and set the event name on the event Helper to dispatch Guzzle events and set the event name on the event Parameters `$eventName` `string` $eventName Name of the event to dispatch `$context` `array` $context Context of the event Implementation of `Guzzle\Common\HasDispatcherInterface::dispatch()`
`public AbstractHasDispatcher`	# `addSubscriber( Symfony\Component\EventDispatcher\EventSubscriberInterface $subscriber )` Add an event subscriber to the dispatcher Add an event subscriber to the dispatcher Parameters `$subscriber` `Symfony\Component\EventDispatcher\EventSubscriberInterface` $subscriber Event subscriber Returns `AbstractHasDispatcher` CodeCoverageIgnore Implementation of `Guzzle\Common\HasDispatcherInterface::addSubscriber()`
`public Guzzle\Http\Message\Request`	# `setIsRedirect( boolean $isRedirect )` Set whether or not the request is a request that resulted from a redirect Set whether or not the request is a request that resulted from a redirect Parameters `$isRedirect` `boolean` $isRedirect Returns `Guzzle\Http\Message\Request` Implementation of `Guzzle\Http\Message\RequestInterface::setIsRedirect()`
`public boolean`	# `isRedirect( )` Check whether or not the request is a request that resulted from a redirect Check whether or not the request is a request that resulted from a redirect Returns `boolean` Implementation of `Guzzle\Http\Message\RequestInterface::isRedirect()`
`protected`	# `changedHeader( string $header )` Check to see if the modified headers need to reset any of the managed headers like cache-control Check to see if the modified headers need to reset any of the managed headers like cache-control Parameters `$header` `string` $header Header that changed Overrides `Guzzle\Http\Message\AbstractMessage::changedHeader()`
`protected array`	# `getEventArray( )` Get an array containing the request and response for event notifications Get an array containing the request and response for event notifications Returns `array`
`protected`	# `processResponse( array $context = array() )` Process a received response Process a received response Parameters `$context` `array` $context Contextual information Throws `Guzzle\Http\Exception\RequestException\|Guzzle\Http\Exception\BadResponseException` on unsuccessful responses

Methods inherited from Guzzle\Http\Message\AbstractMessage
`addCacheControlDirective(), addHeader(), addHeaders(), getCacheControlDirective(), getHeader(), getHeaderLines(), getHeaders(), getParams(), getTokenizedHeader(), hasCacheControlDirective(), hasHeader(), removeCacheControlDirective(), removeHeader(), setHeader(), setHeaders(), setTokenizedHeader()`

Constants inherited from Guzzle\Http\Message\RequestInterface
`CONNECT, DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT, STATE_COMPLETE, STATE_ERROR, STATE_NEW, STATE_TRANSFER, TRACE`

Properties summary
`protected Symfony\Component\EventDispatcher\EventDispatcherInterface`	`$eventDispatcher`		#
`protected Guzzle\Http\Url`	`$url`		# HTTP Url HTTP Url
`protected string`	`$method`		# HTTP method (GET, PUT, POST, DELETE, HEAD, OPTIONS, TRACE) HTTP method (GET, PUT, POST, DELETE, HEAD, OPTIONS, TRACE)
`protected Guzzle\Http\ClientInterface`	`$client`		#
`protected Guzzle\Http\Message\Response`	`$response`		# Response of the request Response of the request
`protected Guzzle\Http\EntityBodyInterface`	`$responseBody`		# Response body Response body
`protected string`	`$state`		# State of the request object State of the request object
`protected string`	`$username`		# Authentication username Authentication username
`protected string`	`$password`		# Auth password Auth password
`protected Guzzle\Common\Collection`	`$curlOptions`		# cURL specific transfer options cURL specific transfer options
`protected boolean`	`$isRedirect`	`false`	#

Properties inherited from Guzzle\Http\Message\AbstractMessage
`$headers, $params, $protocolVersion`

Namespaces

Classes

Interfaces

Class Request

Direct known subclasses

Returns

Implementation of

Parameters

See

Returns

Implementation of

Parameters

Throws

Parameters

Returns

Implementation of

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Throws

Implementation of

Returns

Implementation of

Returns

Implementation of

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Throws

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of

Returns

Implementation of

Parameters

Returns

Implementation of