Simple Guzzle Client for a Laravel application

v0.4.2 2018-10-02 11:40 UTC


MIT licensed Latest Stable Version

A Simple Guzzle Client for a Laravel application


  • PHP 7.1 or higher
  • Laravel 5.5 or 5.6


Via composer

$ composer require dpc/guzzle-client


Inject the contract into the class where you need the client:

 * @var RequestClientContract
protected $client;

 * @param RequestClientContract $client
public function __construct(RequestClientContract $client)
    $this->client = $client;

You can then use the client by first calling make, to set the base URI - and then populating the request. The client returns a normal PSR ResponseInterface. This means you interact with the response as you would with any Guzzle response.

$client = $this->client->make('https://httpbin.org/');

	'foo' => 'bar'
	'baz' => 'qux'
	'allow_redirects' => false

echo $response->getBody();
echo $response->getStatusCode();

Alternatively, you can include both the body, headers and options in a single call.

$client = $this->client->make('https://httpbin.org/');

$response = $client->to('get')->with([
    'foo' => 'bar'
], [
    'baz' => 'qux'
], [
    'allow_redirects' => false

echo $response->getBody();
echo $response->getStatusCode();

The asJson() method will send the data using json key in the Guzzle request. (You can use asFormParams() to send the request as form params).

Available methods / Example Usage

$client = $this->client->make('https://httpbin.org/');

// Get request
$response = $client->to('brotli')->get();

// Post request
$response = $client->to('post')->withBody([
	'foo' => 'bar'

// Put request
$response = $client->to('put')->withBody([
	'foo' => 'bar'

// Patch request
$response = $client->to('patch')->withBody([
	'foo' => 'bar'

// Delete request
$response = $client->to('delete?id=1')->delete();

// Headers are easily added using the withHeaders method
$response = $client->to('get')->withHeaders([
	'Authorization' => 'Bearer fooBar'

// Custom options can be specified for the Guzzle instance
$response = $client->to('redirect/5')->withOptions([
	'allow_redirects' => [
		'max' => 5,
		'protocols' => [

// You can also specify the request method as a string
$response = $client->to('post')->withBody([
	'foo' => 'bar'


Using debug(bool|resource) before sending a request turns on Guzzle's debugger, more information about that here.

The debugger is turned off after every request, if you need to debug multiple requests sent sequentially you will need to turn on debugging for all of them.


$logFile = './guzzle_client_debug_test.log';
$logFileResource = fopen($logFile, 'w+');

	'foo' => 'random data'


This writes Guzzle's debug information to guzzle_client_debug_test.log.


This package follows semver. Features introduced & any breaking changes created in major releases are mentioned in releases.


This package is created as a basic wrapper for Guzzle based on what I needed in a few projects. If you need any other features of Guzzle, you can create a issue here or send a PR to master branch.

If you need help or have any questions you can:


Dylan DPC


The MIT License (MIT)

Copyright (c) 2017 Dylan DPC