Cliente HTTP en PHP: haciendo solicitudes correctamente de la A a la Z

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

En el desarrollo web moderno, las aplicaciones PHP rara vez existen de forma aislada. Casi todos los proyectos interactúan con servicios externos: sistemas de pago, API de redes sociales, almacenamiento en la nube o microservicios propios. Para ello, es necesario un cliente HTTP en PHP confiable que permita enviar solicitudes, procesar respuestas y gestionar conexiones.

En este artículo, analizaremos todas las formas de crear un cliente HTTP en PHP: desde las funciones integradas más simples hasta bibliotecas profesionales. Aprenderá cómo manejar errores correctamente, trabajar con encabezados y tiempos de espera, y también obtendrá ejemplos de código listos para usar.

El material será útil tanto para principiantes que recién comienzan a aprender PHP como para desarrolladores experimentados que desean sistematizar sus conocimientos.

1. Herramientas integradas de PHP para solicitudes HTTP

PHP proporciona varias herramientas integradas para trabajar con HTTP. Veamos las más populares.

1.1. file_get_contents() — una forma sencilla

La forma más sencilla de enviar una solicitud GET es usar la función file_get_contents(). Esta lee el contenido de un archivo o URL en una cadena.

<?php$url = 'https://api.example.com/data';$response = file_get_contents($url);

if ($response === false) {    echo 'Error al ejecutar la solicitud';} else {    echo $response;}?>

Ventajas: código mínimo, no requiere extensiones adicionales.

Desventajas: no admite solicitudes POST, es difícil gestionar encabezados, no hay manejo de tiempos de espera, no es adecuado para producción.

1.2. stream_context_create() — configuración de contexto

Para un trabajo más flexible, use stream_context_create(). Este método permite establecer el método de solicitud, los encabezados y el cuerpo de la solicitud.

<?php$data = json_encode(['name' => 'John', 'age' => 30]);

$options = [    'http' => [        'method' => 'POST',        'header' => "Content-Type: application/json\\r" .                     "Content-Length: " . strlen($data) . "\\r",        'content' => $data,        'timeout' => 10    ]];

$context = stream_context_create($options);$response = file_get_contents('https://api.example.com/users', false, $context);

if ($response === false) {    echo 'Error de solicitud';} else {    $result = json_decode($response, true);    print_r($result);}?>

Este enfoque es mejor, pero aún tiene limitaciones en funcionalidad y rendimiento.

2. cURL — un potente cliente HTTP en PHP

cURL (Client URL Library) es la herramienta estándar para trabajar con HTTP en PHP. Proporciona el máximo control sobre las solicitudes y es compatible prácticamente en todos los alojamientos.

2.1. Envío básico de una solicitud GET

<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/users');curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_error($ch)) {    echo 'Error de cURL: ' . curl_error($ch);} else {    echo "Código HTTP: $httpCode";    echo $response;}

curl_close($ch);?>

2.2. Solicitud POST con datos

<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/users');curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['name' => 'Alice', 'email' => 'alice@example.com']));curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [    'Content-Type: application/x-www-form-urlencoded',    'Authorization: Bearer your_token_here']);

$response = curl_exec($ch);$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);curl_close($c