Cliente HTTP en PHP: haciendo solicitudes correctamente

Introducción: ¿por qué necesitas un cliente HTTP en PHP?

Las aplicaciones web modernas rara vez existen de forma aislada. Interactúan con APIs externas, servicios de arquitectura de microservicios, sistemas de análisis y pasarelas de pago. En el centro de esta interacción se encuentra el protocolo HTTP. Para un desarrollador de PHP, saber cómo enviar correctamente solicitudes HTTP no es solo una habilidad útil, sino una parte obligatoria del conjunto de herramientas profesionales.

En este artículo, analizaremos tres formas principales de crear un cliente HTTP en PHP: desde el simple file_get_contents() hasta el potente cURL y el moderno paquete Guzzle. Aprenderás cómo elegir la herramienta adecuada, manejar errores, trabajar con cabeceras y garantizar la seguridad de las solicitudes.

1. Solicitudes simples con file_get_contents()

La forma más sencilla de enviar una solicitud GET en PHP es usar la función incorporada file_get_contents(). Este método es adecuado para prototipos rápidos y escenarios simples donde no se requiere una configuración fina de la conexión.

Solicitud GET básica

<?php$url = 'https://api.example.com/data';$response = file_get_contents($url);if ($response === false) {    echo 'Error al obtener los datos';} else {    echo $response;}?>

Configuración del contexto de flujo

Para gestionar las cabeceras y el método de la solicitud, usa stream_context_create(). Esto permite enviar solicitudes POST y establecer cabeceras personalizadas.

<?php$data = json_encode(['name' => 'John', 'email' => 'john@example.com']);$options = [    'http' => [        'method' => 'POST',        'header' => "Content-Type: application/json\\r" .                     "Accept: application/json\\r",        'content' => $data    ]];$context = stream_context_create($options);$result = file_get_contents('https://api.example.com/users', false, $context);if ($result === false) {    // Manejo de errores}?>

Desventajas: file_get_contents() no soporta cookies, tiempos de espera a nivel de conexión, manejo de redirecciones ni trabajo con certificados SSL. Para proyectos serios, es mejor usar cURL o Guzzle.

2. cURL potente y flexible

La extensión cURL (Client URL Library) es la herramienta estándar para trabajar con HTTP en PHP. Proporciona control total sobre la solicitud: cabeceras, cuerpo, tiempos de espera, autenticación, trabajo con archivos y mucho más.

Solicitud GET básica con cURL

<?php$ch = curl_init('https://api.example.com/data');curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_TIMEOUT, 30);$response = curl_exec($ch);if (curl_errno($ch)) {    echo 'Error de cURL: ' . curl_error($ch);} else {    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);    echo "Código HTTP: $httpCode";    echo $response;}curl_close($ch);?>

Solicitud POST con JSON y cabeceras

<?php$postData = ['title' => 'PHP HTTP Client', 'body' => 'Ejemplo de solicitud'];$jsonData = json_encode($postData);$ch = curl_init('https://jsonplaceholder.typicode.com/posts');curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_POSTFIELDS => $jsonData,    CURLOPT_HTTPHEADER => [        'Content-Type: application/json',        'Accept: application/json',        'Authorization: Bearer YOUR_TOKEN_HERE'    ],    CURLOPT_TIMEOUT => 15,    CURLOPT_SSL_VERIFYPEER => true // ¡En producción siempre true!]);$result = curl_exec($ch);$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);curl_close($ch);if ($httpCode >= 200 && $httpCode < 300) {    $decoded = json_decode($result, true);    print_r($decoded);} else {    echo "Error: HTTP $httpCode";}?>

Opciones útiles de cURL

• CURLOPT_