HTTP

The HTTP module allow you to make request via cURL.

Request an URL

---

You can perform an HTTP request (GET,POST,PUT,DELETE) on a passed URL via the HTTP::get/post/put/delete methods.

$homepage = HTTP::get("http://www.caffeinalab.com");

If the response header Content-Type: application/json is present, returned payload will be automatically decoded to a PHP object.

$caffeina = HTTP::get('http://graph.facebook.com/caffeinalab');
echo $caffeina->website;

http://caffeinalab.com

Passing data to a request

---

You can pass data to the request defining an associative array as the second parameter for the call.

HTTP::post("http://api.example.com/user",[
  'name'     => 'Frank',
  'surname'  => 'Castle',
  'email'    => '[email protected]',
]);

By default, POST/PUT data is sended via application/x-www-form-urlencoded, you can switch to a application/json encoding by passing true to the HTTP::useJSON method.

HTTP::useJSON(true);
HTTP::post("http://api.example.com/user",[
  'name'     => 'Frank',
  'surname'  => 'Castle',
  'email'    => '[email protected]',
]);

POST http://api.example.com/user
Content-Type: application/json

{
  "name": "Frank",
  "surname": "Castle",
  "email": "[email protected]"
}

Adding headers

---

You can pass extra headers per request defining an associative array as the third parameter for the call.

$results = HTTP::get("http://api.example.com/item",[],[
  'Authorization' => 'Bearer d7033f287da887b1d463830ba48b9982',
]);

GET http://api.example.com/item
Authorization: Bearer d7033f287da887b1d463830ba48b9982

A global header can be appended to every request by using the HTTP::addHeader($name, $value) method.

HTTP::addHeader('X-Extra','Howdy');
$results = HTTP::get("http://api.example.com/item",[],[
  'Authorization' => 'Bearer d7033f287da887b1d463830ba48b9982',
]);

GET http://api.example.com/item
X-Extra: Howdy
Authorization: Bearer d7033f287da887b1d463830ba48b9982

A global header can be removed via the HTTP::removeHeader($name) method.

HTTP::removeHeader('X-Extra');

By default the current user-agent is used in all requests :

Mozilla/4.0 (compatible; Core::HTTP; Windows NT 6.1)

You can however change it with the HTTP::userAgent($value) method.

HTTP::userAgent('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/36.0.1985.143 Safari/537.36');