Как использовать cURL в PHP для отправки HTTP GET запросов

Расширенные примеры использования cURL для GET запросов

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

Пример полного цикла с проверкой HTTP-статуса и обработкой ошибок

<?php
function curl_get_contents($url, $timeout = 30) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($ch, CURLOPT_MAXREDIRS, 3);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
    curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem');
    curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36');
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    $errno = curl_errno($ch);
    curl_close($ch);
    
    if ($errno) {
        throw new Exception("cURL ошибка ($errno): $error");
    }
    if ($httpCode >= 400) {
        throw new Exception("HTTP ошибка: $httpCode");
    }
    return $response;
}

try {
    $data = curl_get_contents('https://jsonplaceholder.typicode.com/posts/1');
    echo $data;
} catch (Exception $e) {
    echo 'Ошибка: ' . $e->getMessage();
}
?>

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit..."
}

Как отправить GET запрос с куками (cookies) и сохранить их для последующих запросов

<?php
$cookieFile = '/tmp/cookies.txt'; // файл для хранения кук

// Первый запрос - получаем куки
$ch = curl_init('https://example.com/login');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_COOKIEJAR, $cookieFile); // сохранять новые куки
curl_setopt($ch, CURLOPT_COOKIEFILE, $cookieFile); // отправлять сохранённые
$response = curl_exec($ch);
curl_close($ch);

// Второй запрос - куки уже присутствуют
$ch2 = curl_init('https://example.com/dashboard');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch2, CURLOPT_COOKIEFILE, $cookieFile);
$dashboard = curl_exec($ch2);
curl_close($ch2);
echo $dashboard;
?>

Пояснение:

CURLOPT_COOKIEJAR указывает файл, в который cURL запишет куки из ответа сервера. CURLOPT_COOKIEFILE задаёт файл, откуда брать куки для отправки. Обычно оба указывают на один и тот же файл.

Как использовать cURL в цикле для массовых GET запросов (с ограничением параллельности)

<?php
$urls = [
    'https://api1.example.com/items/1',
    'https://api1.example.com/items/2',
    'https://api1.example.com/items/3'
];
$multiHandle = curl_multi_init();
$curlHandles = [];

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

$active = null;
do {
    $mrc = curl_multi_exec($multiHandle, $active);
} while ($mrc == CURLM_CALL_MULTI_PERFORM || $active);

foreach ($curlHandles as $ch) {
    $response = curl_multi_getcontent($ch);
    echo 'Ответ: ' . $response . PHP_EOL;
    curl_multi_remove_handle($multiHandle, $ch);
    curl_close($ch);
}
curl_multi_close($multiHandle);
?>

Результат:

Ответ: {"id":1,"name":"Item 1"}
Ответ: {"id":2,"name":"Item 2"}
Ответ: {"id":3,"name":"Item 3"}

Назначение:

curl_multi позволяет выполнять запросы асинхронно, ускоряя выборку множества URL. Важно обрабатывать завершение каждого запроса, так как curl_multi_exec не блокирует выполнение.

Как отправить GET запрос с базовой HTTP-аутентификацией

<?php
$ch = curl_init('https://api.example.com/secure');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, 'username:password');
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Пояснение:

Авторизация передаётся в заголовке Authorization: Basic .... Тип аутентификации можно комбинировать: CURLAUTH_ANY.

Как обработать ответ в формате JSON и получить конкретное поле

<?php
$ch = curl_init('https://api.example.com/user/123');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if (json_last_error() === JSON_ERROR_NONE) {
    echo 'Имя пользователя: ' . ($data['name'] ?? 'не указано');
} else {
    echo 'Ошибка декодирования JSON';
}
?>

Имя пользователя: Иван Петров

Как логировать все этапы запроса (отладка)

<?php
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_VERBOSE, true);
$verbose = fopen('php://temp', 'w+');
curl_setopt($ch, CURLOPT_STDERR, $verbose);

$response = curl_exec($ch);

rewind($verbose);
$log = stream_get_contents($verbose);
echo "<pre>Лог запроса:\n$log</pre>";

curl_close($ch);
?>

Результат:

*   Trying 93.184.216.34:443...
* Connected to api.example.com (93.184.216.34) port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
...

Назначение:

Опция CURLOPT_VERBOSE включает вывод подробной информации о рукопожатии, заголовках и времени. Данные направляются в поток, заданный CURLOPT_STDERR.

Как ограничить скорость загрузки (bandwidth throttling)

<?php
$ch = curl_init('https://speedtest.example.com/largefile');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_MAX_RECV_SPEED_LARGE, 1024 * 50); // 50 KB/s
$data = curl_exec($ch);
curl_close($ch);
?>

Пояснение:

Опция CURLOPT_MAX_RECV_SPEED_LARGE ограничивает скорость приёма данных. Полезна для предотвращения перегрузки сети.

Как использовать константу CURLOPT_CUSTOMREQUEST для нестандартных методов (но GET остаётся GET)

<?php
$ch = curl_init('https://api.example.com/resource');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET'); // можно не указывать, так как по умолчанию GET
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>

Обычно CURLOPT_CUSTOMREQUEST применяется для методов вроде PATCH или DELETE, но его можно использовать и для явного указания GET.