Gdata/HttpClient.php

+ Show: +

inherited

+ Classes +
- \Zend_Gdata_HttpClient

+ Table of Contents +

Zend Framework

LICENSE

+ +

This source file is subject to the new BSD license that is bundled +with this package in the file LICENSE.txt. +It is also available through the world-wide-web at this URL: +http://framework.zend.com/license/new-bsd +If you did not receive a copy of the license and are unable to +obtain it through the world-wide-web, please send an email +to license@zend.com so we can send you a copy immediately.

Category: Zend + +
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
License: New BSD License + +
Package: Zend_Gdata + +
Subpackage: Gdata + +
Version: $Id: HttpClient.php 24593 2012-01-05 20:35:02Z matthew $ + +

\Zend_Gdata_HttpClient
jump to top

Package: Zend\Gdata\Gdata

Gdata Http Client object.

Class to extend the generic Zend Http Client with the ability to perform +secure AuthSub requests

Parent(s): \Zend_Http_Client
Category: Zend + +
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + +
License: New BSD License + +

Constants

 
+                GET
+                = 'GET'

inherited

HTTP request methods

Inherited from: + \Zend_Http_Client::GET

Inherited_from: \Zend_Http_Client::GET + +

 
+                POST
+                = 'POST'

inheritedInherited from: + \Zend_Http_Client::POST

Inherited_from: \Zend_Http_Client::POST + +

 
+                PUT
+                = 'PUT'

inheritedInherited from: + \Zend_Http_Client::PUT

Inherited_from: \Zend_Http_Client::PUT + +

 
+                HEAD
+                = 'HEAD'

inheritedInherited from: + \Zend_Http_Client::HEAD

Inherited_from: \Zend_Http_Client::HEAD + +

 
+                DELETE
+                = 'DELETE'

inheritedInherited from: + \Zend_Http_Client::DELETE

Inherited_from: \Zend_Http_Client::DELETE + +

 
+                TRACE
+                = 'TRACE'

inheritedInherited from: + \Zend_Http_Client::TRACE

Inherited_from: \Zend_Http_Client::TRACE + +

 
+                OPTIONS
+                = 'OPTIONS'

inheritedInherited from: + \Zend_Http_Client::OPTIONS

Inherited_from: \Zend_Http_Client::OPTIONS + +

 
+                CONNECT
+                = 'CONNECT'

inheritedInherited from: + \Zend_Http_Client::CONNECT

Inherited_from: \Zend_Http_Client::CONNECT + +

 
+                MERGE
+                = 'MERGE'

inheritedInherited from: + \Zend_Http_Client::MERGE

Inherited_from: \Zend_Http_Client::MERGE + +

 
+                AUTH_BASIC
+                = 'basic'

inherited

Supported HTTP Authentication methods

Inherited from: + \Zend_Http_Client::AUTH_BASIC

Inherited_from: \Zend_Http_Client::AUTH_BASIC + +

 
+                HTTP_1
+                = '1.1'

inherited

HTTP protocol versions

Inherited from: + \Zend_Http_Client::HTTP_1

Inherited_from: \Zend_Http_Client::HTTP_1 + +

 
+                HTTP_0
+                = '1.0'

inheritedInherited from: + \Zend_Http_Client::HTTP_0

Inherited_from: \Zend_Http_Client::HTTP_0 + +

 
+                CONTENT_TYPE
+                = 'Content-Type'

inherited

Content attributes

Inherited from: + \Zend_Http_Client::CONTENT_TYPE

Inherited_from: \Zend_Http_Client::CONTENT_TYPE + +

 
+                CONTENT_LENGTH
+                = 'Content-Length'

inheritedInherited from: + \Zend_Http_Client::CONTENT_LENGTH

Inherited_from: \Zend_Http_Client::CONTENT_LENGTH + +

 
+                ENC_URLENCODED
+                = 'application/x-www-form-urlencoded'

inherited

POST data encoding methods

Inherited from: + \Zend_Http_Client::ENC_URLENCODED

Inherited_from: \Zend_Http_Client::ENC_URLENCODED + +

 
+                ENC_FORMDATA
+                = 'multipart/form-data'

inheritedInherited from: + \Zend_Http_Client::ENC_FORMDATA

Inherited_from: \Zend_Http_Client::ENC_FORMDATA + +

 
+                VTYPE_SCALAR
+                = 'SCALAR'

inherited

Value types for Body key/value pairs

Inherited from: + \Zend_Http_Client::VTYPE_SCALAR

Inherited_from: \Zend_Http_Client::VTYPE_SCALAR + +

 
+                VTYPE_FILE
+                = 'FILE'

inheritedInherited from: + \Zend_Http_Client::VTYPE_FILE

Inherited_from: \Zend_Http_Client::VTYPE_FILE + +

Properties

resource $_authSubPrivateKeyId = null

OpenSSL private key resource id +This key is used for AuthSub authentication.

If this value is set, +it is assuemd that secure AuthSub is desired.

Default valuenullDetails

Type: resource

string $_authSubToken = null

Token for AuthSub authentication.

If this token is set, AuthSub authentication is used.

Default valuenullDetails

Type: string

string $_clientLoginKey = null

Token for ClientLogin authentication.

If this token is set, and the AuthSub key is not set, +ClientLogin authentication is used

Default valuenullDetails

Type: string

string $_clientLoginToken = null

Token for ClientLogin authentication.

If only this token is set, ClientLogin authentication is used.

Default valuenullDetails

Type: string

resource $_fileInfoDb = null

staticinherited

Fileinfo magic database resource

Inherited from: + \Zend_Http_Client::$$_fileInfoDb

This variable is populated the first time _detectFileMimeType is called +and is then reused on every call to this method

Default valuenullDetails

Type: resource
Inherited_from: \Zend_Http_Client::$$_fileInfoDb + +

boolean $_queryBracketsEscaped = true

inherited

Status if the http_build_query function escapes brackets

Inherited from: + \Zend_Http_Client::$$_queryBracketsEscaped

Default valuetrueDetails

Type: boolean
Inherited_from: \Zend_Http_Client::$$_queryBracketsEscaped + +

bool $_streamingRequest = null

True if this request is being made with data supplied by +a stream object instead of a raw encoded string.

Default valuenullDetails

Type: bool

boolean $_unmaskStatus = false

inherited

Status for unmasking GET array params

Inherited from: + \Zend_Http_Client::$$_unmaskStatus

Default valuefalseDetails

Type: boolean
Inherited_from: \Zend_Http_Client::$$_unmaskStatus + +

\Zend_Http_Client_Adapter_Interface $adapter = null

inherited

The adapter used to perform the actual connection to the server

Inherited from: + \Zend_Http_Client::$$adapter

Default valuenullDetails

Type: \Zend_Http_Client_Adapter_Interface
Inherited_from: \Zend_Http_Client::$$adapter + +

array|null $auth

inherited

HTTP Authentication settings

Inherited from: + \Zend_Http_Client::$$auth

Expected to be an associative array with this structure: +$this->auth = array('user' => 'username', 'password' => 'password', 'type' => 'basic') +Where 'type' should be one of the supported authentication types (see the AUTH_* +constants), for example 'basic' or 'digest'.

+ +

If null, no authentication will be used.

Details

Type: array | null
Inherited_from: \Zend_Http_Client::$$auth + +

array $body_field_order = array()

inherited

Ordered list of keys from key/value pair data to include in body

Inherited from: + \Zend_Http_Client::$$body_field_order

An associative array, where each element is of the format: + '' => VTYPE_SCALAR | VTYPE_FILE

Default valuearray()Details

Type: array
Inherited_from: \Zend_Http_Client::$$body_field_order + +

array $config = array('maxredirects' => 5, 'strictredirects' => false, 'useragent' => 'Zend_Http_Client', 'timeout' => 10, 'adapter' => 'Zend_Http_Client_Adapter_Socket', 'httpversion' => self::HTTP_1, 'keepalive' => false, 'storeresponse' => true, 'strict' => true, 'output_stream' => false, 'encodecookies' => true, 'rfc3986_strict' => false)

inherited

Configuration array, set using the constructor or using ::setConfig()

Inherited from: + \Zend_Http_Client::$$config

Default value

array('maxredirects' => 5, 'strictredirects' => false, 'useragent' => 'Zend_Http_Client', 'timeout' => 10, 'adapter' => 'Zend_Http_Client_Adapter_Socket', 'httpversion' => self::HTTP_1, 'keepalive' => false, 'storeresponse' => true, 'strict' => true, 'output_stream' => false, 'encodecookies' => true, 'rfc3986_strict' => false)

Details

Type: array
Inherited_from: \Zend_Http_Client::$$config + +

\Zend_Http_CookieJar $cookiejar = null

inherited

The client's cookie jar

Inherited from: + \Zend_Http_Client::$$cookiejar

Default valuenullDetails

Type: \Zend_Http_CookieJar
Inherited_from: \Zend_Http_Client::$$cookiejar + +

string $enctype = null

inherited

Request body content type (for POST requests)

Inherited from: + \Zend_Http_Client::$$enctype

Default valuenullDetails

Type: string
Inherited_from: \Zend_Http_Client::$$enctype + +

array $files = array()

inherited

File upload arrays (used in POST requests)

Inherited from: + \Zend_Http_Client::$$files

An associative array, where each element is of the format: + 'name' => array('filename.txt', 'text/plain', 'This is the actual file contents')

Default valuearray()Details

Type: array
Inherited_from: \Zend_Http_Client::$$files + +

array $headers = array()

inherited

Associative array of request headers

Inherited from: + \Zend_Http_Client::$$headers

Default valuearray()Details

Type: array
Inherited_from: \Zend_Http_Client::$$headers + +

string $last_request = null

inherited

The last HTTP request sent by the client, as string

Inherited from: + \Zend_Http_Client::$$last_request

Default valuenullDetails

Type: string
Inherited_from: \Zend_Http_Client::$$last_request + +

\Zend_Http_Response $last_response = null

inherited

The last HTTP response received by the client

Inherited from: + \Zend_Http_Client::$$last_response

Default valuenullDetails

Type: \Zend_Http_Response
Inherited_from: \Zend_Http_Client::$$last_response + +

string $method = self::GET

inherited

HTTP request method

Inherited from: + \Zend_Http_Client::$$method

Default valueself::GETDetails

Type: string
Inherited_from: \Zend_Http_Client::$$method + +

array $paramsGet = array()

inherited

Associative array of GET parameters

Inherited from: + \Zend_Http_Client::$$paramsGet

Default valuearray()Details

Type: array
Inherited_from: \Zend_Http_Client::$$paramsGet + +

array $paramsPost = array()

inherited

Associative array of POST parameters

Inherited from: + \Zend_Http_Client::$$paramsPost

Default valuearray()Details

Type: array
Inherited_from: \Zend_Http_Client::$$paramsPost + +

string $raw_post_data = null

inherited

The raw post data to send.

Inherited from: + \Zend_Http_Client::$$raw_post_data

Could be set by setRawData($data, $enctype).

Default valuenullDetails

Type: string
Inherited_from: \Zend_Http_Client::$$raw_post_data + +

int $redirectCounter = 0

inherited

Redirection counter

Inherited from: + \Zend_Http_Client::$$redirectCounter

Default value0Details

Type: int
Inherited_from: \Zend_Http_Client::$$redirectCounter + +

\Zend_Uri_Http $uri = null

inherited

Request URI

Inherited from: + \Zend_Http_Client::$$uri

Default valuenullDetails

Type: \Zend_Uri_Http
Inherited_from: \Zend_Http_Client::$$uri + +

Methods

__construct(\Zend_Uri_Http | string $uri = null, array $config = null) : void

inherited

Constructor method.

Inherited from: + \Zend_Http_Client::__construct()

Will create a new HTTP client. Accepts the target +URL and optionally configuration array.

Parameters

Name	Type	Description
$uri	\Zend_Uri_Http \| string
$config	array	Configuration key-value pairs. +

_detectFileMimeType(string $file) : string

inherited

Attempt to detect the MIME type of a file using available extensions

Inherited from: + \Zend_Http_Client::_detectFileMimeType()

This method will try to detect the MIME type of a file. If the fileinfo +extension is available, it will be used. If not, the mime_magic +extension which is deprected but is still available in many PHP setups +will be tried.

+ +

If neither extension is available, the default application/octet-stream +MIME type will be returned

Parameters

Name	Type	Description
$file	string	File path

Returns

Type	Description
string	MIME type

_flattenParametersArray(array $parray, string $prefix = null) : array

staticinherited

Convert an array of parameters into a flat array of (key, value) pairs

Inherited from: + \Zend_Http_Client::_flattenParametersArray()

Will flatten a potentially multi-dimentional array of parameters (such +as POST parameters) into a flat array of (key, value) paris. In case +of multi-dimentional arrays, square brackets ([]) will be added to the +key to indicate an array.

Parameters

Name	Type	Description
$parray	array
$prefix	string

Returns

Type	Description
array

Details

Since: 1.9 + +

_getParametersRecursive(array $parray, bool $urlencode = false) : array

inherited

Helper method that gets a possibly multi-level parameters array (get or +post) and flattens it.

Inherited from: + \Zend_Http_Client::_getParametersRecursive()

The method returns an array of (key, value) pairs (because keys are not +necessarily unique. If one of the parameters in as array, it will also +add a [] suffix to the key.

+ +

This method is deprecated since Zend Framework 1.9 in favour of +self::_flattenParametersArray() and will be dropped in 2.0

Parameters

Name	Type	Description
$parray	array	The parameters array
$urlencode	bool	Whether to urlencode the name and value

Returns

Type	Description
array

_openTempStream() : resource

inherited

Create temporary stream

Inherited from: + \Zend_Http_Client::_openTempStream()

Returns

Type	Description
resource

_prepareBody() : string

Prepare the request body (for POST and PUT requests)

Returns

Type	Description
string

Throws

Exception	Description
\Zend_Http_Client_Exception

_prepareHeaders() : array

inherited

Prepare the request headers

Inherited from: + \Zend_Http_Client::_prepareHeaders()

Returns

Type	Description
array

_setParameter(string $type, string $name, string $value) : null

inherited

Set a GET or POST parameter - used by SetParameterGet and SetParameterPost

Inherited from: + \Zend_Http_Client::_setParameter()

Parameters

Name	Type	Description
$type	string	GET or POST
$name	string
$value	string

Returns

Type	Description
null

encodeAuthHeader(string $user, string $password, string $type = self::AUTH_BASIC) : string

staticinherited

Create a HTTP authentication "Authorization:" header according to the +specified user, password and authentication method.

Inherited from: + \Zend_Http_Client::encodeAuthHeader()

Parameters

Name	Type	Description
$user	string
$password	string
$type	string

Returns

Type	Description
string

Throws

Exception	Description
\Zend_Http_Client_Exception

Details

See: \http://www.faqs.org/rfcs/rfc2617.html + +

encodeFormData(string $boundary, string $name, mixed $value, string $filename = null, array $headers = array()) : string

staticinherited

Encode data to a multipart/form-data part suitable for a POST request.

Inherited from: + \Zend_Http_Client::encodeFormData()

Parameters

Name	Type	Description
$boundary	string
$name	string
$value	mixed
$filename	string
$headers	array	Associative array of optional headers @example ("Content-Transfer-Encoding" => "binary") +

Returns

Type	Description
string

filterHttpRequest(string $method, string $url, array $headers = array(), string $body = null, string $contentType = null) : array

Filters the HTTP requests being sent to add the Authorization header.

If both AuthSub and ClientLogin tokens are set, +AuthSub takes precedence. If an AuthSub key is set, then +secure AuthSub authentication is used, and the request is signed. +Requests must be signed only with the private key corresponding to the +public key registered with Google. If an AuthSub key is set, but +openssl support is not enabled in the PHP installation, an exception is +thrown.

Parameters

Name	Type	Description
$method	string	The HTTP method
$url	string	The URL
$headers	array	An associate array of headers to be + sent with the request or null
$body	string	The body of the request or null
$contentType	string	The MIME content type of the body or null

Returns

Type	Description
array	The processed values in an associative array, + using the same names as the params

Throws

Exception	Description
\Zend_Gdata_App_Exception	if there was a signing failure

filterHttpResponse(\Zend_Http_Response $response) : \Zend_Http_Response

Method for filtering the HTTP response, though no filtering is +currently done.

Parameters

Name	Type	Description
$response	\Zend_Http_Response	The response object to filter

Returns

Type	Description
\Zend_Http_Response	The filterd response object

getAdapter() : \Zend_Http_Client_Adapter_Interface | string

Return the current connection adapter

Returns

Type	Description
\Zend_Http_Client_Adapter_Interface \| string	$adapter

getAuthSubPrivateKeyId() : string

Gets the openssl private key id

Returns

Type	Description
string	The private key

getAuthSubToken() : string

Gets the AuthSub token used for authentication

Returns

Type	Description
string	The token

getClientLoginToken() : string

Gets the ClientLogin token used for authentication

Returns

Type	Description
string	The token

getCookieJar() : \Zend_Http_CookieJar | null

inherited

Return the current cookie jar or null if none.

Inherited from: + \Zend_Http_Client::getCookieJar()

Returns

Type	Description
\Zend_Http_CookieJar \| null

getHeader(string $key) : string | array | null

inherited

Get the value of a specific header

Inherited from: + \Zend_Http_Client::getHeader()

Note that if the header has more than one value, an array +will be returned.

Parameters

Name	Type	Description
$key	string

Returns

Type	Description
string \| array \| null	The header value or null if it is not set

getLastRequest() : string

inherited

Get the last HTTP request as string

Inherited from: + \Zend_Http_Client::getLastRequest()

Returns

Type	Description
string

getLastResponse() : \Zend_Http_Response

inherited

Get the last HTTP response received by this client

Inherited from: + \Zend_Http_Client::getLastResponse()

If $config['storeresponse'] is set to false, or no response was +stored yet, will return null

Returns

Type	Description
\Zend_Http_Response	or null if none

getRedirectionsCount() : int

inherited

Get the number of redirections done on the last request

Inherited from: + \Zend_Http_Client::getRedirectionsCount()

Returns

Type	Description
int

getStream() : boolean | string

inherited

Get status of streaming for received data

Inherited from: + \Zend_Http_Client::getStream()

Returns

Type	Description
boolean \| string

getStreamingRequest() : boolean

Check whether the client is set to perform streaming requests.

Returns

Type	Description
boolean	True if yes, false otherwise.

getUnmaskStatus() : boolean

inherited

Returns the currently configured unmask status

Inherited from: + \Zend_Http_Client::getUnmaskStatus()

Returns

Type	Description
boolean

getUri(boolean $as_string = false) : \Zend_Uri_Http | string

inherited

Get the URI for the next request

Inherited from: + \Zend_Http_Client::getUri()

Parameters

Name	Type	Description
$as_string	boolean	If true, will return the URI as a string

Returns

Type	Description
\Zend_Uri_Http \| string

request(string $method = null) : \Zend_Http_Response

inherited

Send the HTTP request and return an HTTP response object

Inherited from: + \Zend_Http_Client::request()

Parameters

Name	Type	Description
$method	string

Returns

Type	Description
\Zend_Http_Response

Throws

Exception	Description
\Zend_Http_Client_Exception

resetParameters(bool $clearAll = false) : \Zend_Http_Client

Clear all custom parameters we set.

Should be used to reset the request parameters if the client is +used for several concurrent requests.

+ +

clearAll parameter controls if we clean just parameters or also +headers and last_*

Parameters

Name	Type	Description
$clearAll	bool	Should all data be cleared? +

Returns

Type	Description
\Zend_Http_Client

setAdapter(\Zend_Http_Client_Adapter_Interface $adapter) : void

Load the connection adapter

While this method is not called more than one for a client, it is +seperated from ->request() to preserve logic and readability

Parameters

Name	Type	Description
$adapter	\Zend_Http_Client_Adapter_Interface

Throws

Exception	Description
\Zend_Http_Client_Exception

setAuth(string | false $user, string $password = '', string $type = self::AUTH_BASIC) : \Zend_Http_Client

inherited

Set HTTP authentication parameters

Inherited from: + \Zend_Http_Client::setAuth()

$type should be one of the supported types - see the self::AUTH_* +constants.

+ +

To enable authentication:

+ +

$this->setAuth('shahar', 'secret', Zend_Http_Client::AUTH_BASIC);
+

+ +

To disable authentication:

+ +

$this->setAuth(false);
+

Parameters

Name	Type	Description
$user	string \| false	User name or false disable authentication
$password	string	Password
$type	string	Authentication type

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

Details

See: \http://www.faqs.org/rfcs/rfc2617.html + +

setAuthSubPrivateKey(string $key, string $passphrase = null) : \Zend_Gdata_HttpClient

Sets the PEM formatted private key to be used for secure AuthSub auth.

In order to call this method, openssl must be enabled in your PHP +installation. Otherwise, a Zend_Gdata_App_InvalidArgumentException +will be thrown.

Parameters

Name	Type	Description
$key	string	The private key
$passphrase	string	The optional private key passphrase

Returns

Type	Description
\Zend_Gdata_HttpClient	Provides a fluent interface

Throws

Exception	Description
\Zend_Gdata_App_InvalidArgumentException

setAuthSubPrivateKeyFile(string $file, string $passphrase = null, bool $useIncludePath = false) : void

Sets the PEM formatted private key, as read from a file.

This method reads the file and then calls setAuthSubPrivateKey() +with the file contents.

Parameters

Name	Type	Description
$file	string	The location of the file containing the PEM key
$passphrase	string	The optional private key passphrase
$useIncludePath	bool	Whether to search the include_path + for the file

setAuthSubToken(string $token) : \Zend_Gdata_HttpClient

Sets the AuthSub token used for authentication

Parameters

Name	Type	Description
$token	string	The token

Returns

Type	Description
\Zend_Gdata_HttpClient	Provides a fluent interface

setClientLoginToken(string $token) : \Zend_Gdata_HttpClient

Sets the ClientLogin token used for authentication

Parameters

Name	Type	Description
$token	string	The token

Returns

Type	Description
\Zend_Gdata_HttpClient	Provides a fluent interface

setConfig(\Zend_Config $config = array()) : \Zend_Http_Client

inherited

Set configuration parameters for this HTTP client

Inherited from: + \Zend_Http_Client::setConfig()

Parameters

Name	Type	Description
$config	\Zend_Config	\| array $config +

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setCookie(\Zend_Http_Cookie | string $cookie, string | null $value = null) : \Zend_Http_Client

inherited

Add a cookie to the request.

Inherited from: + \Zend_Http_Client::setCookie()

If the client has no Cookie Jar, the cookies +will be added directly to the headers array as "Cookie" headers.

Parameters

Name	Type	Description
$cookie	\Zend_Http_Cookie \| string
$value	string \| null	If "cookie" is a string, this is the cookie value. +

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setCookieJar(\Zend_Http_CookieJar | boolean $cookiejar = true) : \Zend_Http_Client

inherited

Set the HTTP client's cookie jar.

Inherited from: + \Zend_Http_Client::setCookieJar()

A cookie jar is an object that holds and maintains cookies across HTTP requests +and responses.

Parameters

Name	Type	Description
$cookiejar	\Zend_Http_CookieJar \| boolean	Existing cookiejar object, true to create a new one, false to disable

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setEncType(string $enctype = self::ENC_URLENCODED) : \Zend_Http_Client

inherited

Set the encoding type for POST data

Inherited from: + \Zend_Http_Client::setEncType()

Parameters

Name	Type	Description
$enctype	string

Returns

Type	Description
\Zend_Http_Client

setFileUpload(string $filename, string $formname, string $data = null, string $ctype = null) : \Zend_Http_Client

inherited

Set a file to upload (using a POST request)

Inherited from: + \Zend_Http_Client::setFileUpload()

Can be used in two ways:

+ +

$data is null (default): $filename is treated as the name if a local file which +will be read and sent. Will try to guess the content type using mime_content_type().
$data is set - $filename is sent as the file name, but $data is sent as the file +contents and no file is read from the file system. In this case, you need to +manually set the Content-Type ($ctype) or it will default to +application/octet-stream.

Parameters

Name	Type	Description
$filename	string	Name of file to upload, or name to save as
$formname	string	Name of form element to send as
$data	string	Data to send (if null, $filename is read and sent) +
$ctype	string	Content type to use (if $data is set and $ctype is + null, will be application/octet-stream) +

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setHeaders(string | array $name, mixed $value = null) : \Zend_Http_Client

inherited

Set one or more request headers

Inherited from: + \Zend_Http_Client::setHeaders()

This function can be used in several ways to set the client's request +headers: +1. By providing two parameters: $name as the header to set (e.g. 'Host') + and $value as it's value (e.g. 'www.example.com'). +2. By providing a single header string as the only parameter + e.g. 'Host: www.example.com' +3. By providing an array of headers as the first parameter + e.g. array('host' => 'www.example.com', 'x-foo: bar'). In This case + the function will call itself recursively for each array item.

Parameters

Name	Type	Description
$name	string \| array	Header name, full header string ('Header: value') + or an array of headers +
$value	mixed	Header value or null

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setMethod(string $method = self::GET) : \Zend_Http_Client

inherited

Set the next request's method

Inherited from: + \Zend_Http_Client::setMethod()

Validated the passed method and sets it. If we have files set for +POST requests, and the new method is not POST, the files are silently +dropped.

Parameters

Name	Type	Description
$method	string

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

setParameterGet(string | array $name, string $value = null) : \Zend_Http_Client

inherited

Set a GET parameter for the request.

Inherited from: + \Zend_Http_Client::setParameterGet()

Wrapper around _setParameter

Parameters

Name	Type	Description
$name	string \| array
$value	string

Returns

Type	Description
\Zend_Http_Client

setParameterPost(string | array $name, string $value = null) : \Zend_Http_Client

inherited

Set a POST parameter for the request.

Inherited from: + \Zend_Http_Client::setParameterPost()

Wrapper around _setParameter

Parameters

Name	Type	Description
$name	string \| array
$value	string

Returns

Type	Description
\Zend_Http_Client

setRawData(string | resource $data, string $enctype = null) : \Zend_Http_Client

inherited

Set the raw (already encoded) POST data.

Inherited from: + \Zend_Http_Client::setRawData()

This function is here for two reasons: +1. For advanced user who would like to set their own data, already encoded +2. For backwards compatibilty: If someone uses the old post($data) method. + this method will be used to set the encoded data.

+ +

$data can also be stream (such as file) from which the data will be read.

Parameters

Name	Type	Description
$data	string \| resource
$enctype	string

Returns

Type	Description
\Zend_Http_Client

setRawDataStream(string $data, string $enctype = null) : \Zend_Http_Client

Set the raw (already encoded) POST data from a stream source.

This is used to support POSTing from open file handles without +caching the entire body into memory. It is a wrapper around +Zend_Http_Client::setRawData().

Parameters

Name	Type	Description
$data	string	The request data
$enctype	string	The encoding type

Returns

Type	Description
\Zend_Http_Client

setStream(string | boolean $streamfile = true) : \Zend_Http_Client

inherited

Set streaming for received data

Inherited from: + \Zend_Http_Client::setStream()

Parameters

Name	Type	Description
$streamfile	string \| boolean	Stream file, true for temp file, false/null for no streaming +

Returns

Type	Description
\Zend_Http_Client

setStreamingRequest(boolean $value) : void

Set the streamingRequest variable which controls whether we are +sending the raw (already encoded) POST data from a stream source.

Parameters

Name	Type	Description
$value	boolean	The value to set.

setUnmaskStatus(boolean $status = true) : \Zend_Http_Client

inherited

Set the unmask feature for GET parameters as array

Inherited from: + \Zend_Http_Client::setUnmaskStatus()

Example: +foo%5B0%5D=a&foo%5B1%5D=b +becomes +foo=a&foo=b

+ +

This is usefull for some services

Parameters

Name	Type	Description
$status	boolean

Returns

Type	Description
\Zend_Http_Client

setUri(\Zend_Uri_Http | string $uri) : \Zend_Http_Client

inherited

Set the URI for the next request

Inherited from: + \Zend_Http_Client::setUri()

Parameters

Name	Type	Description
$uri	\Zend_Uri_Http \| string

Returns

Type	Description
\Zend_Http_Client

Throws

Exception	Description
\Zend_Http_Client_Exception

Gdata/HttpClient.php

\Zend_Gdata_HttpClientjump to top

Constants

Properties

Methods

\Zend_Gdata_HttpClient
jump to top