rmiller/hal-guzzle-response

Adds Hal resources to Guzzle Responses

HalGuzzleResponse

, _(*1)

Guzzle event subscriber to decorate responses to provide Hal resources., _(*2)

If you register the listener it will decorate the responses from Guzzle giving them a hal method. This will return a Nocarrier\Hal resource created from the response body., _(*3)

Installation

Require the extension:, _(*4)

$ composer require rmiller/hal-guzzle-response:~0.1

Usage

Attach the listener:, _(*5)

$client = new \GuzzleHttp\Client();
$emitter = $client->getEmitter();
$subscriber = new \RMiller\HalGuzzleResponse\GuzzleSubscriber();
$emitter->attach($subscriber);

Get the Hal resource from the response:, _(*6)

$response = $client->get($url);
$hal = $response->hal(); //\Nocarrier\Hal

Note: an attempt will be made to convert the response body from JSON and XML to a Hal resource. If neither is successful a \RuntimeException will be thrown. This happens when hal is called, so it is safe to wrap other responses and not call hal., _(*7)