walker/incutio-php-http-client

HttpClient is a client class for the HTTP protocol.

About

This is a continuation of the Incutio PHP HTTP Client class. It's still one of the better standalone HTTP client classes out there. I'm just going to make it do more., _(*1)

Of all I can find on the HTTP spec, body content is allowed with POST, PUT, and DELETE requests, so we allow you to send body content when using this client., _(*2)

Instantiation

$client = new HttpClient('www.domain.com', 80);

Where the first argument is the domain and the second is the port. The port is optional and default to 80 if not provided., _(*3)

If you'd like to instantiate on an https:// URL, add it to the domain:, _(*4)

$client = new HttpClient('https://www.domain.com');

This will automatically use port 443 when connecting., _(*5)

Basic Authentication

If the API you are accessing using this library requires basic authentication:, _(*6)

$client->setAuthorization('username', 'password');

GET

$data can be an object or array. $headers should be an array, _(*7)

$client->get('/service/endpoint', $data, $headers);

POST

$data can be a string, object, or array. $headers should be an array, _(*8)

$client->post('/service/endpoint', $data, $headers);

PUT

$data can be a string, object, or array. $headers should be an array, _(*9)

$client->put('/service/endpoint', $data, $headers);

DELETE

$data can be a string, object, or array. $headers should be an array, _(*10)

$client->put('/service/endpoint', $data, $headers)

Headers

Content-Type on requests is no longer set by default., _(*11)

If Accept is not set, it defaults to:, _(*12)

'text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,image/jpeg,image/gif,*/*'

Headers should be things like:, _(*13)

array('Accept'=>'application/json', 'Content-Type':'text/xml', 'etc')

$data and $headers are optional in all of these., _(*14)

Referer

The Incutio library used to set the referer of a call as the last item called. I rarely find this helpful, so it's turned off by default now. To turn it back on:, _(*15)

$this->client->setPersistReferers(true);

Response Content

Get the content returned by the most recent URL call., _(*16)

$client->getContent();

Response Headers

You can get just the status or all the headers from your most recent URL call:, _(*17)

$client->getStatus();
$client->getHeaders();