This version is outdated. You should upgrade your project to Mako 9.1 or Mako 10.0!
master
10.0 9.1
show older versions 9.0 8.1 8.0 7.3 7.2 7.1 7.0 6.3 6.2 6.1 6.0 5.7 5.6 5.5 5.4 5.3 5.2 5.1 5.0 4.5 3.6
Learn more

REST client

Mako includes a basic REST that client makes it easy to interact with RESTful web services.

Usage

First you'll need to create a Rest object. Use the optional options parameter to set CURL options.

$rest = new Rest('http://example.org/api');

$rest = new Rest('http://example.org/api', array(CURLOPT_CONNECTTIMEOUT => 1));

If you need to provide authentication then you can use the authenticate method.

$rest->authenticate('username', 'password');

The get method performs a GET request and returns the response.

$response = $rest->get();

The head method performs a HEAD request and returns the response headers in a nicely formatted array.

$headers = $rest->head();

The post method performs a POST request and returns the response.

$movie = array
(
	'title'    => 'Thor',
	'category' => 'Action',
);

$response = $rest->post($movie);

The put method performs a PUT request and returns the response.

$movie = array
(
	'title'    => 'Thor',
	'category' => 'Action',
);

$response = $rest->put(json_encode($movie));

The delete method performs a DELETE request and returns the response.

$response = $rest->delete();

The info method returns info about the last cURL request.

$rest = new Rest('http://example.org/api');

$response = $rest->get();

if($rest->info('http_code') != 200)
{
	// something went wrong
}
else
{
	// everything is ok
}

You can also set the $info parameter offered by the request methods to save a few lines of code.

$response = Rest::factory('http://example.org')->get($info);

if($info['http_code'] != 200)
{
	// something went wrong
}
else
{
	// everything is ok
}