Применение cURL в PHP для взаимодействия с HTTP сервисами

Как отправить простой GET запрос с параметрами?

Цель: получить данные от удаленного API, передав параметры в URL.

$url = 'https://api.example.com/users';
$params = ['page' => 1, 'limit' => 10];
$url .= '?' . http_build_query($params);

$result = curl_request($url, 'GET');
if ($result['http_code'] === 200) {
    $data = json_decode($result['response'], true);
    // обработка данных
} else {
    echo 'Ошибка: ' . $result['http_code'];
}

Как передать данные через POST запрос в формате JSON?

Цель: отправить структурированные данные в теле запроса (например, для REST API).

$data = ['name' => 'Иван', 'email' => 'ivan@example.com'];
$json = json_encode($data);

$url = 'https://api.example.com/users';
$headers = ['Content-Type: application/json'];

$result = curl_request($url, 'POST', $json, $headers);

Проблема: если не указать заголовок Content-Type: application/json, сервер может не распознать JSON. Также важно правильно кодировать UTF-8.

Как выполнить POST запрос с URL-кодированными данными (form-data)?

Цель: имитация отправки HTML формы.

$form_data = ['username' => 'user', 'password' => 'pass'];
$url = 'https://example.com/login';

$result = curl_request($url, 'POST', http_build_query($form_data));

Обратите внимание, что http_build_query автоматически кодирует данные.

Как загрузить файл на сервер через multipart/form-data?

Цель: отправка файла вместе с другими полями (например, аватар).

$file_path = '/path/to/file.jpg';
$ch = curl_init('https://example.com/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = [
    'file' => new CURLFile($file_path, 'image/jpeg', 'avatar.jpg'),
    'description' => 'Мой аватар'
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);

Важно:

Если используется CURLFile, PHP автоматически установит Content-Type: multipart/form-data. Не нужно добавлять заголовок вручную.

Как установить пользовательские заголовки (User-Agent, Authorization)?

Цель: имитация браузера или авторизация через токен.

$url = 'https://api.example.com/protected';
$token = 'Bearer abc123';
$headers = [
    'Authorization: ' . $token,
    'User-Agent: MyApp/1.0',
    'Accept: application/json'
];
$result = curl_request($url, 'GET', null, $headers);

Как управлять cookie в cURL (сохранение и отправка)?

Цель: поддержка сессии между запросами.

$cookie_file = '/tmp/cookies.txt';
$ch = curl_init('https://example.com/login');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie_file);
curl_setopt($ch, CURLOPT_COOKIEFILE, $cookie_file);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['user' => 'admin', 'pass' => '123']);
$response = curl_exec($ch);
curl_close($ch);
// последующие запросы будут использовать те же cookies

Проблема: файл cookie может быть недоступен для записи. Убедиться в правах доступа или использовать временную директорию.

Как выполнить запрос через прокси-сервер?

Цель: обход ограничений или анонимизация.

$ch = curl_init('https://httpbin.org/ip');
curl_setopt($ch, CURLOPT_PROXY, 'http://proxy.example.com:3128');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'user:pass');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Типы прокси:

Как обработать редиректы и получить финальный URL?

Цель: узнать, куда привел редирект (например, после сокращения ссылки).

$ch = curl_init('http://bit.ly/example');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 3);
$response = curl_exec($ch);
$final_url = curl_getinfo($ch, CURLINFO_EFFECTIVE_URL);
curl_close($ch);
echo 'Финальный URL: ' . $final_url;

Как выполнить несколько запросов параллельно (cURL Multi)?

Цель: ускорение загрузки данных с нескольких серверов одновременно.

$urls = ['https://api1.com', 'https://api2.com', 'https://api3.com'];
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $i => $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($mh, $ch);
    $handles[$i] = $ch;
}
$running = null;
do {
    curl_multi_exec($mh, $running);
    curl_multi_select($mh);
} while ($running > 0);
foreach ($handles as $ch) {
    $response = curl_multi_getcontent($ch);
    // обработка ответа
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);

Проблема: неконтролируемое количество одновременных соединений. Можно ограничить через CURLOPT_CONNECTTIMEOUT или использовать curl_multi_select для ожидания.

Как отлаживать запросы cURL (вывод заголовков и деталей)?

Цель: увидеть что отправляется и приходит для диагностики.

$ch = curl_init('https://example.com');
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);
$verbose_output = stream_get_contents($verbose);
fclose($verbose);
echo 'Отладочная информация:';
echo '<pre>' . htmlspecialchars($verbose_output) . '</pre>';
curl_close($ch);

Также можно использовать CURLOPT_HEADER = true для включения заголовков ответа в тело.