Configuración de Proxy PHP

La configuración de un proxy PHP para cURL, Guzzle y file_get_contents implica configurar las opciones del cliente HTTP o los contextos de flujo para enrutar las solicitudes salientes a través de un servidor proxy especificado, típicamente definiendo el host, puerto y credenciales de autenticación del proxy.

El uso de un servidor proxy con PHP permite a las aplicaciones enmascarar su dirección IP de origen, eludir restricciones geográficas, acceder a recursos de redes internas o gestionar las tasas de solicitud para el web scraping y las interacciones con API. La elección del método depende del control requerido, la complejidad de las solicitudes y las necesidades de manejo de errores.

Usando cURL

cURL es una biblioteca robusta para realizar solicitudes HTTP, que ofrece un control extenso sobre los parámetros de conexión, incluida la configuración del proxy. Es una opción común para interacciones web complejas y suele estar disponible como una extensión de PHP (php-curl).

Configuración Básica del Proxy

Para enrutar una solicitud a través de un proxy HTTP o HTTPS, use CURLOPT_PROXY y CURLOPT_PROXYPORT.

<?php
$ch = curl_init();

// URL de destino
curl_setopt($ch, CURLOPT_URL, 'http://example.com/api/data');

// Configuración del proxy
curl_setopt($ch, CURLOPT_PROXY, 'proxy.example.com');
curl_setopt($ch, CURLOPT_PROXYPORT, 8080);

// Devolver la transferencia como una cadena en lugar de mostrarla directamente
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

Proxy SOCKS

cURL soporta proxies SOCKS (SOCKS4, SOCKS4a, SOCKS5, SOCKS5h). Especifique el tipo de proxy usando CURLOPT_PROXYTYPE.

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://example.com/api/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Configuración del proxy SOCKS5
curl_setopt($ch, CURLOPT_PROXY, 'socks5.example.com');
curl_setopt($ch, CURLOPT_PROXYPORT, 1080);
curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5); // O CURLPROXY_SOCKS4, CURLPROXY_SOCKS4A, CURLPROXY_SOCKS5_HOSTNAME

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

Proxy con Autenticación

Para proxies que requieren autenticación, use CURLOPT_PROXYUSERPWD con una cadena username:password.

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://example.com/api/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Configuración del proxy con autenticación
curl_setopt($ch, CURLOPT_PROXY, 'authproxy.example.com');
curl_setopt($ch, CURLOPT_PROXYPORT, 8080);
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'proxyuser:proxypassword');

// Opcional: Especificar el método de autenticación del proxy (ej., CURLAUTH_BASIC, CURLAUTH_DIGEST)
// curl_setopt($ch, CURLOPT_PROXYAUTH, CURLAUTH_BASIC);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

Proxy HTTPS (Túnel CONNECT)

Al conectarse a un destino HTTPS a través de un proxy HTTP, cURL utiliza el método HTTP CONNECT para establecer un túnel. CURLOPT_HTTPPROXYTUNNEL puede habilitar esto explícitamente, aunque a menudo se maneja automáticamente.

<?php
$ch = curl_init();

// URL HTTPS de destino
curl_setopt($ch, CURLOPT_URL, 'https://secure.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Configuración del proxy
curl_setopt($ch, CURLOPT_PROXY, 'proxy.example.com');
curl_setopt($ch, CURLOPT_PROXYPORT, 8080);

// Habilitar el túnel para HTTPS a través de un proxy HTTP (a menudo implícito)
curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, true);

// Manejar la verificación del certificado SSL (deshabilitar para pruebas, habilitar para producción)
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); 
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

Opciones Comunes de cURL para Proxies

• CURLOPT_TIMEOUT: Tiempo máximo en segundos para la operación cURL.
• CURLOPT_CONNECTTIMEOUT: Tiempo máximo en segundos para establecer una conexión.
• CURLOPT_FOLLOWLOCATION: Seguir cualquier encabezado HTTP Location:.
• CURLOPT_MAXREDIRS: Número máximo de redirecciones a seguir.
• CURLOPT_SSL_VERIFYPEER, CURLOPT_SSL_VERIFYHOST: Controlar la verificación del certificado SSL. Establecer en true para producción.
• CURLOPT_HEADER: Incluir el encabezado en la salida.

Usando Guzzle

Guzzle es un popular cliente HTTP de PHP que proporciona una abstracción de nivel superior sobre cURL, simplificando las tareas HTTP comunes. Requiere instalación a través de Composer.

Configuración Básica del Proxy

Los clientes y solicitudes de Guzzle aceptan una opción proxy. Esto se puede definir globalmente para un cliente o por solicitud.

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client([
    // URI base para todas las solicitudes realizadas con este cliente
    'base_uri' => 'http://example.com/',
    // Configuración global del proxy para el cliente
    'proxy' => 'http://proxy.example.com:8080',
]);

try {
    $response = $client->request('GET', 'api/data');
    echo $response->getBody();
} catch (GuzzleHttp\Exception\RequestException $e) {
    echo 'Guzzle error: ' . $e->getMessage();
}
?>

Proxy con Autenticación

Incluya las credenciales de autenticación directamente en la URI del proxy para proxies HTTP/HTTPS.

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'http://example.com/',
    // Proxy con autenticación
    'proxy' => 'http://proxyuser:proxypassword@authproxy.example.com:8080',
]);

try {
    $response = $client->request('GET', 'api/data');
    echo $response->getBody();
} catch (GuzzleHttp\Exception\RequestException $e) {
    echo 'Guzzle error: ' . $e->getMessage();
}
?>

Proxy SOCKS

Especifique los proxies SOCKS usando el esquema socks en la URI del proxy.

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'http://example.com/',
    // Proxy SOCKS5
    'proxy' => 'socks5://socks5.example.com:1080',
]);

try {
    $response = $client->request('GET', 'api/data');
    echo $response->getBody();
} catch (GuzzleHttp\Exception\RequestException $e) {
    echo 'Guzzle error: ' . $e->getMessage();
}
?>

Proxies por Solicitud

La opción proxy puede ser sobrescrita o especificada para solicitudes individuales.

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client(); // Sin proxy global

try {
    $response = $client->request('GET', 'http://example.com/api/data', [
        'proxy' => 'http://perrequestproxy.example.com:8080', // Proxy para esta solicitud específica
    ]);
    echo $response->getBody();
} catch (GuzzleHttp\Exception\RequestException $e) {
    echo 'Guzzle error: ' . $e->getMessage();
}
?>

Opciones Comunes de Guzzle para Proxies

• proxy: La cadena URI del proxy (http://, https://, socks4://, socks5://).
• verify: Controla la verificación del certificado SSL (true, false, o ruta al paquete CA).
• timeout: Tiempo de espera total para la solicitud en segundos.
• connect_timeout: Tiempo de espera para conectarse al servidor en segundos.
• allow_redirects: Controla el manejo de redirecciones (true, false, o array de opciones).

Usando file_get_contents

file_get_contents es una función simple para leer el contenido de archivos, incluidas las URLs. Puede usar contextos de flujo para configurar los ajustes del proxy, pero ofrece menos control y manejo de errores en comparación con cURL o Guzzle. Es adecuada para solicitudes HTTP/HTTPS básicas con requisitos de proxy simples.

Configuración Básica del Proxy

Use stream_context_create para definir la configuración del proxy dentro de las opciones http.

<?php
$proxy = 'tcp://proxy.example.com:8080';
$url = 'http://example.com/api/data';

$context = stream_context_create([
    'http' => [
        'proxy' => $proxy,
        'request_fulluri' => true, // Esencial para proxies HTTP
    ],
]);

$response = @file_get_contents($url, false, $context);

if ($response === false) {
    echo 'Failed to retrieve content via proxy.';
} else {
    echo $response;
}
?>

request_fulluri debe establecerse en true cuando se utiliza un proxy HTTP, ya que instruye al cliente a enviar la URI completa en la línea de solicitud (por ejemplo, GET http://example.com/path HTTP/1.0).

Proxy HTTPS

Para destinos HTTPS, el wrapper de flujo https maneja la configuración del proxy de manera similar a http.

<?php
$proxy = 'tcp://proxy.example.com:8080';
$url = 'https://secure.example.com/data';

$context = stream_context_create([
    'http' => [ // Nota: La configuración del proxy sigue estando en 'http' para el túnel CONNECT
        'proxy' => $proxy,
        'request_fulluri' => true,
    ],
    'ssl' => [ // Opciones de verificación SSL/TLS
        'verify_peer' => false, // Deshabilitar para pruebas, habilitar para producción
        'verify_peer_name' => false,
    ],
]);

$response = @file_get_contents($url, false, $context);

if ($response === false) {
    echo 'Failed to retrieve content via proxy.';
} else {
    echo $response;
}
?>

Proxy con Autenticación

La autenticación de proxy para file_get_contents se maneja típicamente configurando manualmente el encabezado Proxy-Authorization dentro de las opciones del contexto http.

<?php
$proxy = 'tcp://proxy.example.com:8080';
$url = 'http://example.com/api/data';
$proxyUser = 'proxyuser';
$proxyPass = 'proxypassword';

// Codificar en Base64 el username:password para la autenticación Basic
$authHeader = 'Proxy-Authorization: Basic ' . base64_encode("$proxyUser:$proxyPass");

$context = stream_context_create([
    'http' => [
        'proxy' => $proxy,
        'request_fulluri' => true,
        'header' => $authHeader,
    ],
]);

$response = @file_get_contents($url, false, $context);

if ($response === false) {
    echo 'Failed to retrieve content via proxy.';
} else {
    echo $response;
}
?>

Limitaciones de file_get_contents con Proxies

• Sin Soporte para Proxy SOCKS: Los wrappers de flujo de PHP no soportan proxies SOCKS de forma nativa.
• Manejo de Errores Limitado: La información de error es mínima, basándose en advertencias o valores de retorno false.
• Menos Control: El control granular sobre los encabezados de solicitud, tiempos de espera y manejo de redirecciones es menos flexible.
• Rendimiento: Puede ser menos eficiente para solicitudes concurrentes o numerosas en comparación con cURL.

Comparación de Métodos de Proxy PHP