Использование curl_setopt для конфигурации cURL в PHP

Раздел: PHP -> HTTP запросы с cURL

Основные принципы работы с curl_setopt

Функция curl_setopt позволяет задать параметры cURL-сессии. Наиболее эффективный способ настройки запроса - последовательная установка всех необходимых опций перед вызовом curl_exec. Базовый шаблон включает инициализацию, установку URL и флага возврата результата:


$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Php curl timeout (php curl таймаут)

После выполнения переменная $response содержит тело ответа. Если требуется сохранить ответ в файл, используется опция CURLOPT_FILE. Такой подход подходит для большинства сценариев: получение HTML, JSON, загрузка файлов.

Типичные ошибки:

  • Пропуск CURLOPT_RETURNTRANSFER приводит к прямому выводу результата.
  • Неверный URL вызывает ошибку соединения, которую можно отловить через curl_error.
  • Отсутствие проверки на curl_exec === false может скрыть сбой.

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

Для изменения строки User-Agent применяется константа CURLOPT_USERAGENT.


curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MyBot/1.0)');

Php curl ssl (php curl ssl)

Это может потребоваться при имитации браузера или для обхода ограничений. Без установки сервер видит значение по умолчанию (например, PHP cURL).

Некоторые серверы проверяют не только User-Agent, но и другие заголовки (Accept, Referer), что может потребовать дополнительной настройки.

Как отправить POST запрос с данными?

Переключение метода на POST выполняется опциями CURLOPT_POST и передачей данных через CURLOPT_POSTFIELDS. Данные могут быть строкой или массивом (тогда cURL автоматически задаёт multipart/form-data).


curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['name' => 'John', 'age' => 30]);

Php curl ответ (ответ php curl)

Для отправки JSON данные предварительно кодируют функцией json_encode и устанавливают заголовок Content-Type.


$data = json_encode(['key' => 'value']);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

Php curl authorization (php curl авторизация)

Если передаётся массив и требуется строковое представление (например, application/x-www-form-urlencoded), используется http_build_query. Ошибка: забывают установить CURLOPT_POST, тогда данные отправляются методом GET параметров.

Как настроить обработку SSL сертификатов?

Для работы с HTTPS серверами cURL проверяет валидность SSL-сертификата. Отключение проверки (не рекомендуется для продакшена) выполняется так:


curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

Php curl close (php curl close)

Правильный способ - указать путь к CA-бандлу:


curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem');

Php curl cookie (php curl cookie)

Это гарантирует безопасное соединение. CURLOPT_SSL_VERIFYHOST со значением 2 (по умолчанию) проверяет совпадение имени хоста.

Ошибка: если файл CA отсутствует, cURL выводит SSL certificate problem. Решение - скачать актуальный бандл с сайта curl.haxx.se или использовать системный сертификат.

Как установить таймауты подключения и выполнения?

Два ключевых параметра - CURLOPT_CONNECTTIMEOUT (время на установку соединения) и CURLOPT_TIMEOUT (максимальное время выполнения всего запроса). Оба задаются в секундах:


curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

Php curl url (php curl url)

Если сервер не отвечает в течение указанного времени, cURL прерывает запрос и возвращает false. Тайм-ауты особенно важны при работе с внешними API, чтобы избежать зависания скрипта.

Слишком маленький таймаут приводит к ложным сбоям на медленных каналах. Рекомендуется выставлять значения, исходя из тестов сервера.

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

Для маршрутизации запроса через прокси применяются опции CURLOPT_PROXY и, при необходимости, CURLOPT_PROXYUSERPWD:


curl_setopt($ch, CURLOPT_PROXY, 'http://proxy.example.com:8080');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'username:password');

Curl exec php (php curl exec)

Поддерживаются различные типы прокси (HTTP, SOCKS5). Для SOCKS5 добавляется CURLOPT_PROXYTYPE:


curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);

Curl setopt php (php curl setopt)

Цель: обход ограничений по IP, балансировка нагрузки или анонимизация.

Если прокси требует аутентификации, но пароль не указан, cURL возвращает ошибку 407. Важно правильно экранировать спецсимволы в логине/пароле.

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

Для отправки файла вместе с другими данными используется массив в CURLOPT_POSTFIELDS, где значение - путь к файлу с префиксом @ (устаревший стиль) или объект класса CURLFile (рекомендуется).


$file = new CURLFile('/path/to/file.txt', 'text/plain', 'file.txt');
curl_setopt($ch, CURLOPT_POSTFIELDS, ['upload' => $file, 'description' => 'example']);
upload

cURL автоматически устанавливает заголовок Content-Type: multipart/form-data. Без использования CURLFile на PHP 5.5+ может возникнуть ошибка устаревания.

Большие файлы могут превысить лимит памяти в PHP. Для потоковой передачи применяется CURLOPT_INFILE и CURLOPT_INFILESIZE.

- Php curl content (содержимое ответа php curl)
- Php curl init (php curl init)
- Php curl error (ошибки php curl)

Дополнительные примеры и расширенные сценарии

Работа с Cookie

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

Пример 

$ch = curl_init('https://httpbin.org/cookies/set?name=value');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_COOKIEJAR, '/tmp/cookies.txt');
curl_setopt($ch, CURLOPT_COOKIEFILE, '/tmp/cookies.txt');
$response = curl_exec($ch);
curl_close($ch);

Ответ сервера (httpbin) возвращает установленные куки.
Повторный запрос с тем же файлом отправит сохранённые куки.

Следование редиректам

Включение автоматического перехода по редиректам (301, 302):

Пример 

curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 5); // максимальное количество переходов

Если сервер возвращает 302, cURL выполнит запрос к новому URL без вмешательства.
Без этой опции в ответе будет пустое тело и код 302.

Отправка нескольких заголовков

Массив заголовков через CURLOPT_HTTPHEADER:

Пример 

$headers = [
    'Authorization: Bearer token123',
    'Accept: application/json',
    'X-Custom: value'
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

Все указанные заголовки передаются в запросе.
Конфликт с предопределёнными заголовками (например, Content-Type) разрешается в пользу явно заданных.

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

После выполнения curl_exec можно извлечь метаданные:

Пример 

$info = curl_getinfo($ch);
echo 'HTTP код: ' . $info['http_code'] . "\n";
echo 'Общее время: ' . $info['total_time'] . " сек";

HTTP код: 200
Общее время: 0.234 сек

Параллельные запросы с curl_multi

Обработка нескольких запросов одновременно для ускорения:

Пример 

$urls = ['https://api.example.com/1', 'https://api.example.com/2'];
$handles = [];
$mh = curl_multi_init();
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);
} while ($running > 0);

foreach ($handles as $ch) {
    $response = curl_multi_getcontent($ch);
    echo $response . "\n---\n";
    curl_multi_remove_handle($mh, $ch);
}
curl_multi_close($mh);

Выводятся ответы от каждого URL поочерёдно (порядок не гарантирован).
Увеличивается скорость за счёт одновременного соединения.

Настройка соединения через cURL-константы

Для тонкой настройки можно комбинировать опции. Пример - отправка PUT запроса с JSON:

Пример 

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://httpbin.org/put');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['foo' => 'bar']));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);

Сервер httpbin возвращает данные отправленного запроса в JSON.

PHP cURL setopt - comments

En
Curl setopt php (php)