Функция curl_init в PHP: инициализация сеанса cURL для работы с HTTP

Продвинутые примеры использования cURL в PHP

Пример 1: Запрос с базовой аутентификацией (HTTP Basic)

Для доступа к ресурсам, защищённым базовой аутентификацией, используется опция CURLOPT_USERPWD. Пример:

$ch = curl_init('https://api.example.com/private');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, 'username:password');
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP код: " . $httpCode . "\n";
echo $response;

HTTP код: 200
{"status":"success","data":...}

Если сервер использует дайджест-аутентификацию, применяется CURLOPT_HTTPAUTH с CURLAUTH_DIGEST.

Пример 2: Отправка JSON через POST

Многие современные API ожидают JSON. Необходимо правильно задать Content-Type и сериализовать данные.

$data = ['title' => 'Example', 'body' => 'Content', 'userId' => 1];
$json = json_encode($data);
$ch = curl_init('https://jsonplaceholder.typicode.com/posts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $json,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($json)
    ]
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "Code: $httpCode\n";
echo $response;

Code: 201
{
  "title": "Example",
  "body": "Content",
  "userId": 1,
  "id": 101
}

Пример 3: Работа с SSL через сертификат CA

Для безопасных HTTPS запросов рекомендуется использовать проверку SSL. Если у вас есть файл CA-сертификата (например, cacert.pem из curl), его путь указывается в CURLOPT_CAINFO.

$ch = curl_init('https://secure.example.com');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO         => '/path/to/cacert.pem',
    CURLOPT_SSL_VERIFYHOST => 2
]);
$response = curl_exec($ch);
if ($response === false) {
    echo "Ошибка SSL: " . curl_error($ch);
}
curl_close($ch);

Если проверка отключена (CURLOPT_SSL_VERIFYPEER = false), снижается безопасность соединения.

Пример 4: Загрузка файла с прогрессом

С помощью CURLOPT_PROGRESSFUNCTION можно отслеживать прогресс загрузки (download) или отправки (upload). Функция обратного вызова получает аргументы с размерами.

function progressCallback($resource, $download_size, $downloaded, $upload_size, $uploaded) {
    if ($download_size > 0) {
        $percent = round($downloaded / $download_size * 100);
        echo "Загружено: $percent%\n";
    }
}

$ch = curl_init('https://example.com/largefile.zip');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROGRESSFUNCTION => 'progressCallback',
    CURLOPT_NOPROGRESS       => false   // отключаем встроенный прогресс
]);
$data = curl_exec($ch);
curl_close($ch);

Результат - строка из вызовов коллбэка в консоли. Важно: CURLOPT_NOPROGRESS должен быть false.

Пример 5: Использование cURL с proxy (HTTP/HTTPS)

Для работы через прокси-сервер устанавливаются опции CURLOPT_PROXY, CURLOPT_PROXYPORT и, если требуется аутентификация, CURLOPT_PROXYUSERPWD.

$ch = curl_init('http://httpbin.org/ip');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROXY          => '192.168.1.100',
    CURLOPT_PROXYPORT      => 3128,
    CURLOPT_PROXYUSERPWD   => 'user:pass'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

{
  "origin": "192.168.1.100"
}

Тип прокси можно задать через CURLOPT_PROXYTYPE (например, CURLPROXY_SOCKS5).

Пример 6: Получение информации о запросе (curl_getinfo)

После выполнения запроса можно извлечь метаданные: HTTP код, размер, время выполнения, эффективный URL и др.

$ch = curl_init('https://www.example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$body = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);
echo "HTTP code: " . $info['http_code'] . "\n";
echo "Content type: " . $info['content_type'] . "\n";
echo "Total time: " . $info['total_time'] . " сек\n";
echo "Effective URL: " . $info['url'] . "\n";

HTTP code: 200
Content type: text/html; charset=UTF-8
Total time: 0.234 сек
Effective URL: https://www.example.com/

Пример 7: Запрос с пользовательским методом (DELETE, PUT, PATCH)

Опция CURLOPT_CUSTOMREQUEST позволяет задать любой HTTP метод. Например, DELETE запрос с телом (некоторые API требуют тело и при удалении).

$data = ['reason' => 'test'];
$json = json_encode($data);
$ch = curl_init('https://api.example.com/resource/123');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_POSTFIELDS     => $json,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json']
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP $httpCode: $response";

Пример 8: Использование cURL через file_get_contents с контекстом (альтернативный подход)

Хотя это не cURL, иногда упоминается как альтернатива. Создание потока с помощью stream_context_create и выполнение GET запроса:

$opts = [
    'http' => [
        'method' => 'GET',
        'header' => "User-Agent: MyAgent/1.0\r\n"
    ]
];
$context = stream_context_create($opts);
$result = file_get_contents('http://example.com', false, $context);
if ($result === false) {
    echo "Ошибка получения данных";
} else {
    echo $result;
}

Недостатки: нет поддержки параллельных запросов, менее гибкая обработка ошибок, ограниченные возможности настройки SSL.

Пример 9: Закрытие и повторное использование handle

Handle можно переиспользовать для нескольких последовательных запросов, меняя только URL или другие опции. Это экономит ресурсы.

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Первый запрос
curl_setopt($ch, CURLOPT_URL, 'http://api1.example.com');
$result1 = curl_exec($ch);

// Второй запрос (сброс некоторых опций не обязателен)
curl_setopt($ch, CURLOPT_URL, 'http://api2.example.com');
$result2 = curl_exec($ch);

curl_close($ch);

Важно: при смене URL cURL может сбрасывать некоторые внутренние состояния (например, cookie), но общие опции (таймауты, заголовки) сохраняются.

Пример 10: Обработка chunked transfer encoding

cURL автоматически декодирует chunked ответы, если включена опция CURLOPT_ENCODING с пустой строкой или 'gzip,deflate'. Пример сжатого ответа:

$ch = curl_init('http://httpbin.org/gzip');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING       => 'gzip,deflate'
]);
$response = curl_exec($ch);
curl_close($ch);
var_dump(json_decode($response, true));

array(3) {
  ["gzipped"] => bool(true)
  ["headers"] => array(...)
  ["method"] => string(3) "GET"
}

Без указания CURLOPT_ENCODING cURL не будет обрабатывать сжатие и вернёт бинарные данные.