Cliente HTTP en PHP: haciendo solicitudes correctamente (nivel avanzado)

Introducción: de lo simple a lo complejo

La mayoría de los desarrolladores PHP están familiarizados con las solicitudes HTTP básicas a través de file_get_contents() o un simple curl_init(). Sin embargo, cuando un proyecto crece de la etapa de "proyecto personal" a un sistema de producción, surge la necesidad de herramientas más confiables, flexibles y eficientes. Un cliente HTTP avanzado en PHP no es solo enviar una solicitud GET. Es la gestión de un pool de conexiones, procesamiento asíncrono, reintentos en caso de errores, ajuste fino de tiempos de espera y middleware para registro.

En este artículo, analizaremos cómo construir un cliente HTTP correcto en PHP de nivel avanzado. Aprenderá a usar la librería Guzzle, trabajar con solicitudes asíncronas, manejar excepciones y crear integraciones confiables con APIs externas. El material está dirigido a desarrolladores que ya conocen los fundamentos de PHP y desean llevar la calidad de su código al siguiente nivel.

1. Guzzle: el estándar de facto para solicitudes HTTP en PHP

Si está escribiendo una aplicación seria en PHP, la librería Guzzle (guzzlehttp/guzzle) debería convertirse en su herramienta principal. Abstrae el trabajo con cURL y flujos de PHP, proporcionando una interfaz unificada y conveniente.

1.1 Instalación y solicitud básica

Instalación a través de Composer:

composer require guzzlehttp/guzzle

Ejemplo de una solicitud GET simple con especificación de encabezados y tiempo de espera:

<?phprequire 'vendor/autoload.php';

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

$client = new Client([    'base_uri' => 'https://api.example.com/',    'timeout'  => 5.0, // Tiempo de espera en 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 "Estado: " . $response->getStatusCode() . "";    print_r($data);} catch (RequestException $e) {    echo "Error de solicitud: " . $e->getMessage();    if ($e->hasResponse()) {        echo "Respuesta del servidor: " . $e->getResponse()->getBody();    }}

1.2 Configuración avanzada del cliente

El nivel avanzado implica un ajuste fino. Consideremos los parámetros clave de configuración:

• connect_timeout — tiempo de espera para establecer la conexión (separado del tiempo de espera para la transferencia de datos).
• allow_redirects — gestión de redirecciones (se puede desactivar o limitar la cantidad).
• verify — desactivación de la verificación del certificado SSL (solo para entornos de prueba).
• http_errors — si se establece en false, Guzzle no lanzará excepciones para códigos 4xx y 5xx, permitiendo manejarlos manualmente.
• handler — manejador personalizado para pruebas (MockHandler).

Ejemplo de un cliente con configuración avanzada:

$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. Solicitudes asíncronas y concurrencia

En aplicaciones reales, a menudo es necesario ejecutar varias solicitudes simultáneamente (por ejemplo, cargar datos de varios endpoints). Guzzle proporciona un potente mecanismo de solicitudes asíncronas basado en Promises (su propia implementación de