Getting to Know the Laravel HTTP Client


March 12th, 2020


Laravel 7 has a new HTTP client that provides a minimal API around the popular Guzzle HTTP client. If you missed the news, let’s walk through some of the basics. You can find everything you need to know in the Laravel 7 HTTP Client Documentation, but lets look at some of those features at a glance.

Guzzle is a powerful HTTP client, but the 80% use-case feels complicated when trying to make a simple HTTP GET or getting data back from a JSON API.

Highlight Features

At a glance, here are my favorite features the Laravel Http client provides:

  • Chain-able Request setup
  • Easy access to JSON response data
  • No boilerplate setup to make a simple request
  • Retrying failed requests
  • Convenience methods around authentication headers (basic, digest, bearer)
  • Test fakes and test inspections

For more complicated HTTP client work, you may have to use Guzzle directly, but I suspect that Laravel HTTP has everything that you’d need for most of your projects.

Basic Usage

Here’s the most basic usage you can expect using Laravel’s HTTP client:

1use Illuminate\Support\Facades\Http;
3$response = Http::get('');
5// Get the response body
8$response = Http::get( '' );
10// Array of data from the JSON response
11$data = $response->json();

Accessing Data

There are a few ways you can access data from JSON responses: the json() method and ArrayAccess:

1// Access the response data via `json()`
2$data = $response->json();
5// Array access from the Response object
6Http::get( '' )['username'];
8// Return the response object and access directly
9$response = Http::get('...');

Error Handling

One thing that can get confusing and complicated with Guzzle is continually having to wrap calls in a try/catch block, or creating a mini-abstraction on every project to handle this for you.

Laravel catches 400 and 500 level responses and provides methods you can use to determine if anything bad happened during the response:

1$response = Http::get( '' );
3// Boolean checks on the response
4$response->ok() : bool;
5$response->clientError(): bool;
6$response->successful() : bool;
7$response->serverError() : bool;
8$response->clientError() : bool;


After reading that Laravel handles client and server exceptions, it wasn’t obvious to me at first that timeouts will cause an exception. The default timeout is rather long; however, Laravel HTTP allows you to define it yourself (in seconds) with the convenient timeout() method:

1$response = Http::timeout(5)
2 ->get( '' );
4// Illuminate\Http\Client\ConnectionException:
5// cURL error 28: Connection timed out after 5005 milliseconds

Learn More

You can learn most everything you need to know from the Laravel 7 HTTP Client Documentation. I’d also encourage you to check out the classes in Illuminate/Http—its quite a simple, elegant API which feels intuitive to use.

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.

Laravel News Partners