Cliente HTTP em PHP: fazendo requisições corretamente (nível avançado)

Introdução: do simples ao complexo

A maioria dos desenvolvedores PHP está familiarizada com requisições HTTP básicas através de file_get_contents() ou um simples curl_init(). No entanto, quando o projeto cresce da fase de "projeto pessoal" para um sistema de produção, surge a necessidade de ferramentas mais confiáveis, flexíveis e performáticas. Um cliente HTTP avançado em PHP não é apenas enviar uma requisição GET. É gerenciar pool de conexões, processamento assíncrono, novas tentativas em caso de erros, ajuste fino de timeouts e middleware para logging.

Neste artigo, vamos analisar como construir um cliente HTTP correto em PHP de nível avançado. Você aprenderá como usar a biblioteca Guzzle, trabalhar com requisições assíncronas, tratar exceções e criar integrações confiáveis com APIs externas. O material é voltado para desenvolvedores que já conhecem os fundamentos do PHP e desejam elevar a qualidade do seu código a um novo patamar.

1. Guzzle: o padrão de facto para requisições HTTP em PHP

Se você está escrevendo uma aplicação séria em PHP, a biblioteca Guzzle (guzzlehttp/guzzle) deve se tornar sua principal ferramenta. Ela abstrai o trabalho com cURL e streams PHP, fornecendo uma interface única e conveniente.

1.1 Instalação e requisição básica

Instalação via Composer:

composer require guzzlehttp/guzzle

Exemplo de uma requisição GET simples com especificação de cabeçalhos e timeout:

<?phprequire 'vendor/autoload.php';

use GuzzleHttp\\Client;use GuzzleHttp\\Exception\\RequestException;

$client = new Client([    'base_uri' => 'https://api.example.com/',    'timeout'  => 5.0, // Timeout em segundos    'headers'  => [        'User-Agent' => 'MyApp/1.0',        'Accept'     => 'application/json',    ]]);

try {    $response = $client->get('/users', [        'query' => ['limit' => 10, 'offset' => 0]    ]);        $body = $response->getBody()->getContents();    $data = json_decode($body, true);        echo "Status: " . $response->getStatusCode() . "";    print_r($data);} catch (RequestException $e) {    echo "Erro na requisição: " . $e->getMessage();    if ($e->hasResponse()) {        echo "Resposta do servidor: " . $e->getResponse()->getBody();    }}

1.2 Configuração avançada do cliente

O nível avançado implica em ajuste fino. Vamos analisar os parâmetros chave de configuração:

• connect_timeout — tempo de espera para estabelecer a conexão (separado do timeout de transferência de dados).
• allow_redirects — controle de redirecionamentos (pode desabilitar ou limitar a quantidade).
• verify — desabilitar a verificação do certificado SSL (apenas para ambiente de teste!).
• http_errors — se definido como false, o Guzzle não lançará exceções para códigos 4xx e 5xx, permitindo tratá-los manualmente.
• handler — manipulador personalizado para testes (MockHandler).

Exemplo de cliente com configuração avançada:

$client = new Client([    'base_uri'        => 'https://api.example.com/',    'timeout'         => 10.0,    'connect_timeout' => 3.0,    'allow_redirects' => [        'max' => 5,        'strict' => true,        'referer' => true,        'protocols' => ['https']    ],    'http_errors'     => false,    'headers'         => [        'Authorization' => 'Bearer ' . $token,        'Content-Type'  => 'application/json',    ]]);

2. Requisições assíncronas e concorrência

Em aplicações reais, muitas vezes é necessário executar várias requisições simultaneamente (por exemplo, carregar dados de vários endpoints). O Guzzle fornece um mecanismo poderoso de requisições assíncronas baseado em Promises (sua própria implementação de Promises, que é uma variação do padrão Promise/A+).