The API

Builds cookie headers for a request.

Builds the header.

Builds a request line according to HTTP/1.1 specs. Activate quirks mode to work outside specs.

Takes a $uri array and turns it into a fully qualified URL string

Parses and sets the specified URI into current request configuration.

Build an HTTP Socket using the specified configuration.

You can use a url string to set the url and use default configurations for all other options:

$http =& new HttpSockect('http://cakephp.org/');

Or use an array to configure multiple options:

$http =& new HttpSocket(array(
   'host' => 'cakephp.org',
   'timeout' => 20
));

See HttpSocket::$config for options that can be used.

Generic function to decode a $body with a given $encoding. Returns either an array with the keys 'body' and 'header' or false on failure.

Decodes a chunked message $body and returns either an array with the keys 'body' and 'header' or false as a result.

Issues a DELETE request to the specified URI, query, and request.

Escapes a given $token according to RFC 2616 (HTTP 1.1 specs)

Issues a GET request to the specified URI, query, and request.

Using a string uri and an array of query string parameters:

$response = $http->get('http://google.com/search', array('q' => 'cakephp', 'client' => 'safari'));

Would do a GET request to http://google.com/search?q=cakephp&client=safari

You could express the same thing using a uri array and query string parameters:

$response = $http->get(
    array('host' => 'google.com', 'path' => '/search'),
    array('q' => 'cakephp', 'client' => 'safari')
);

Serializes an array for transport.

Parses cookies in response headers.

Parses an array based header.

This function can be thought of as a reverse to PHP5's http_build_query(). It takes a given query string and turns it into an array and supports nesting by using the php bracket syntax. So this menas you can parse queries like:

• ?key[subKey]=value
• ?key[]=value1&key[]=value2

A leading '?' mark in $query is optional and does not effect the outcome of this function. For the complete capabilities of this implementation take a look at HttpSocketTest::testparseQuery()

Parses the given message and breaks it down in parts.

Parses the given URI and breaks it down into pieces as an indexed array with elements such as 'scheme', 'port', 'query'.

Issues a POST request to the specified URI, query, and request.

post() can be used to post simple data arrays to a url:

$response = $http->post('http://example.com', array(
    'username' => 'batman',
    'password' => 'bruce_w4yne'
));

Issues a PUT request to the specified URI, query, and request.

Issue the specified request. HttpSocket::get() and HttpSocket::post() wrap this method and provide a more granular interface.

Resets the state of this HttpSocket instance to it's initial state (before Object::__construct got executed) or does the same thing partially for the request and the response property only.

Gets escape chars according to RFC 2616 (HTTP 1.1 specs).

Unescapes a given $token according to RFC 2616 (HTTP 1.1 specs)

Normalizes urls into a $uriTemplate. If no template is provided a default one will be used. Will generate the url using the current config information.

Usage:

After configuring part of the request parameters, you can use url() to generate urls.

$http->configUri('http://www.cakephp.org');
$url = $http->url('/search?q=bar');

Would return http://www.cakephp.org/search?q=bar

url() can also be used with custom templates:

$url = $http->url('http://www.cakephp/search?q=socket', '/%path?%query');

Would return /search?q=socket.