isoftware/http-client

HttpClient is a client class for the HTTP protocol.

v0.9 2016-10-04 10:39 UTC

Requires

• php: >=5.2.0

The MIT License

• Simon Willison

• php
• class
• httpclient

README

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.

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.

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.

If you'd like to instantiate on an https:// URL, add it to the domain:

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

This will automatically use port 443 when connecting.

Basic Authentication

If the API you are accessing using this library requires basic authentication:

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

GET

$data can be an object or array. $headers should be an array

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

POST

$data can be a string, object, or array. $headers should be an array

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

PUT

$data can be a string, object, or array. $headers should be an array

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

DELETE

$data can be a string, object, or array. $headers should be an array

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

Headers

Content-Type on requests is no longer set by default.

If Accept is not set, it defaults to:

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

Headers should be things like:

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

$data and $headers are optional in all of these.

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:

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

Response Content

Get the content returned by the most recent URL call.

$client->getContent();

Response Headers

You can get just the status or all the headers from your most recent URL call:

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