Laravel HTTP Client

Tempo de leitura: 3 minutos

Laravel HTTP Client: O Laravel, em suas versões mais recentes, oferece um cliente HTTP integrado que simplifica significativamente a tarefa de realizar requisições HTTP para interagir com APIs externas. Construído sobre o popular cliente Guzzle HTTP, o cliente HTTP do Laravel fornece uma interface fluida e intuitiva para fazer solicitações GET, POST, PUT, DELETE e muito mais.

Neste artigo, vamos explorar as principais funcionalidades do Laravel HTTP Client, desde a realização de requisições básicas até o uso de eventos para personalizar o comportamento do cliente. Acompanhe os exemplos práticos e descubra como otimizar suas aplicações Laravel com essa poderosa ferramenta.

Fazendo Requisições

A forma mais simples de fazer uma requisição GET é utilizando o método get da Facade Http:

PHP

use Illuminate\Support\Facades\Http;

$response = Http::get('https://api.example.com/users');

// Acessando o corpo da resposta
$users = $response->json();

Para outros métodos HTTP, como POST, PUT e DELETE, basta utilizar os métodos correspondentes da fachada Http:

PHP

// Enviando dados em uma requisição POST
Http::post('https://api.example.com/posts', [
    'title' => 'Meu primeiro post',
    'body' => 'Conteúdo do post'
]);

Personalizando as requisições:

Headers: Adicione cabeçalhos personalizados utilizando o método withHeaders:

PHP

Http::withHeaders([
    'Authorization' => 'Bearer your-token'
])->get('https://api.example.com/protected-resource');

Query parameters: Adicione parâmetros de consulta utilizando o método withQuery:

PHP

Http::withQuery(['page' => 2])->get('https://api.example.com/posts');

Dados JSON: Envie dados no formato JSON utilizando o método json:

PHP

Http::post('https://api.example.com/users', [
    'name' => 'John Doe',
    'email' => '[email protected]'
]);

Eventos

O Laravel HTTP Client permite que você crie eventos personalizados para monitorar e personalizar o comportamento das requisições. Esses eventos são disparados em momentos específicos do ciclo de vida de uma requisição, como antes de enviar a requisição, após receber a resposta ou em caso de erro.

Para criar um evento, você precisa registrar um listener no EventServiceProvider:

PHP

protected $listen = [
    'Illuminate\Http\Client\Events\RequestSending' => [
        'App\Listeners\LogRequests',
    ],
];

E então criar o listener:

PHP

namespace App\Listeners;

use Illuminate\Http\Client\Events\RequestSending;

class LogRequests
{
    public function handle(RequestSending $event)
    {
        Log::info('Enviando requisição para: ' . $event->request->url());
    }
}

Conclusão

Laravel HTTP Client: O Laravel HTTP Client é uma ferramenta poderosa e fácil de usar para realizar requisições HTTP em suas aplicações. Com sua interface intuitiva e a possibilidade de personalizar as requisições através de eventos, você pode integrar facilmente sua aplicação com diversas APIs externas.

Mas antes de dominar o Laravel, se for o seu caso, toda jornada tem um início. Vamos entender quais são os conhecimentos básicos necessários para aproveitar ao máximo este poderoso framework. Para iniciar seus estudos no Laravel, você precisará dominar as seguintes tecnologias: