Настройка URL в PHP cURL: от основ до продвинутых методов

Продвинутые примеры работы с URL в cURL

В этом разделе представлены расширенные сценарии использования URL в cURL: многопоточность, работа с прокси, динамическая генерация заголовков и отслеживание редиректов.

Пример 1. Параллельные запросы через curl_multi

Для отправки нескольких запросов одновременно используется curl_multi_init. Каждый дескриптор настраивается с собственным URL.

$urls = [
    'https://api.example.com/data1',
    'https://api.example.com/data2',
    'https://api.example.com/data3'
];
$multiHandle = curl_multi_init();
$curlHandles = [];

foreach ($urls as $i => $url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($multiHandle, $ch);
    $curlHandles[$i] = $ch;
}

$running = null;
do {
    curl_multi_exec($multiHandle, $running);
} while ($running > 0);

foreach ($curlHandles as $ch) {
    $response = curl_multi_getcontent($ch);
    echo 'Результат: ' . substr($response, 0, 100) . "\n";
    curl_multi_remove_handle($multiHandle, $ch);
    curl_close($ch);
}
curl_multi_close($multiHandle);

Результат: {"id":1,"name":"Item1"}
Результат: {"id":2,"name":"Item2"}
Результат: {"id":3,"name":"Item3"}

Пример 2. Отправка POST запроса с URL и телом в JSON

При передаче данных в теле запроса URL остается чистым, а параметры помещаются в CURLOPT_POSTFIELDS.

$url = 'https://api.example.com/submit';
$data = ['user' => 'alice', 'action' => 'login'];
$jsonData = json_encode($data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($jsonData)
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Ответ сервера: {"status":"ok","session":"abc123"}

Пример 3. Работа через прокси с динамическим URL

При использовании прокси URL запроса остается неизменным, но cURL направляет трафик через указанный прокси-сервер.

$proxy = 'http://proxy.example.com:8080';
$url = 'https://httpbin.org/ip';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_PROXY, $proxy);
curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_HTTP);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // только для теста
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo 'IP через прокси: ' . $data['origin'];

IP через прокси: 192.168.1.100

Пример 4. Получение конечного URL после редиректов

cURL может автоматически следовать редиректам, а опция CURLOPT_EFFECTIVE_URL возвращает финальный адрес.

$url = 'https://short.url/xyz';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 5);
$response = curl_exec($ch);
$effectiveUrl = curl_getinfo($ch, CURLINFO_EFFECTIVE_URL);
curl_close($ch);

echo 'Исходный URL: ' . $url . "\n";
echo 'Конечный URL: ' . $effectiveUrl;

Исходный URL: https://short.url/xyz
Конечный URL: https://example.com/long-path

Пример 5. Использование CURLOPT_URL с переменными и условной логикой

Иногда URL формируется динамически в зависимости от условий. Важно обеспечить безопасную конкатенацию.

$environment = 'production';
$endpoints = [
    'development' => 'https://dev.api.example.com',
    'staging'     => 'https://staging.api.example.com',
    'production'  => 'https://api.example.com'
];
$base = $endpoints[$environment] ?? $endpoints['development'];
$resource = '/users/123';
$url = $base . $resource;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    error_log('curl error: ' . curl_error($ch));
}
curl_close($ch);

Ответ: {"id":123,"name":"John"}

Примечание

Во всех примерах предполагается, что PHP настроен с поддержкой cURL. Проверить это можно с помощью phpinfo() или функции function_exists('curl_version').