Как выполнить POST запрос через cURL в PHP: все способы и нюансы

Расширенные примеры отправки POST через cURL в PHP

В этом разделе приведены детальные примеры с пошаговым объяснением и демонстрацией результатов. Все примеры предполагают наличие рабочего тестового сервера (например, https://httpbin.org/post для отладки).

Пример 1: передача массива данных с различными полями (включая вложенные структуры)

Используем http_build_query и CURLOPT_POSTFIELDS для отправки вложенного массива.

$url = 'https://httpbin.org/post';
$data = [
    'name' => 'Иван',
    'age' => 30,
    'address' => [
        'city' => 'Москва',
        'street' => 'Тверская'
    ],
    'tags' => ['php', 'curl', 'post']
];
// http_build_query преобразует вложенные массивы в параметры вида address[city]=Москва&address[street]=Тверская&tags[0]=php...
$postFields = http_build_query($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// Выведем HTTP-код и декодированный JSON-ответ
if ($httpCode === 200) {
    $decoded = json_decode($response, true);
    echo 'Формальные данные, которые получил сервер:' . PHP_EOL;
    print_r($decoded['form']);
} else {
    echo "Ошибка HTTP: $httpCode\n";
}

Результат выполнения:

Формальные данные, которые получил сервер:
Array
(
    [name] => Иван
    [age] => 30
    [address[city]] => Москва
    [address[street]] => Тверская
    [tags[0]] => php
    [tags[1]] => curl
    [tags[2]] => post
)

Обратите внимание: вложенные массивы address и tags разворачиваются в плоскую структуру с квадратными скобками. Если сервер ожидает JSON, такой подход не подойдёт - надо использовать json_encode.

Пример 2: отправка JSON с авторизацией по токену и получение ответа

Демонстрация POST-запроса к https://httpbin.org/post с Bearer-токеном.

$url = 'https://httpbin.org/post';
$token = 'mysecrettoken123';
$payload = [
    'action' => 'create',
    'item' => [
        'title' => 'Новый объект',
        'price' => 100.50
    ]
];
$jsonPayload = json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonPayload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $token
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo 'HTTP-код: ' . $info['http_code'] . PHP_EOL;
echo 'Тело ответа (JSON):' . PHP_EOL;
echo $response . PHP_EOL;

Результат (пример):

HTTP-код: 200
Тело ответа (JSON):
{
  "args": {},
  "data": {
    "action": "create",
    "item": {
      "title": "Новый объект",
      "price": 100.5
    }
  },
  "files": {},
  "form": {},
  "headers": {
    "Authorization": "Bearer mysecrettoken123",
    "Content-Type": "application/json",
    ...
  },
  ...
}

Сервер httpbin.org возвращает отправленные данные в поле data. Обратите внимание на заголовок Authorization, который был передан.

Пример 3: загрузка файла с дополнительными полями формы

Используется CURLFile и массив POSTFIELDS. Сервер httpbin.org принимает файлы и возвращает их содержимое.

$url = 'https://httpbin.org/post';
// Создадим временный файл для примера
$tempFile = tempnam(sys_get_temp_dir(), 'test');
file_put_contents($tempFile, 'Это содержимое тестового файла');

$file = new CURLFile($tempFile, 'text/plain', 'example.txt');
$postData = [
    'file' => $file,
    'description' => 'Загрузка через cURL'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$decoded = json_decode($response, true);
echo 'Полученные файлы:' . PHP_EOL;
print_r($decoded['files']);
echo 'Полученные поля формы:' . PHP_EOL;
print_r($decoded['form']);

// Удалим временный файл
unlink($tempFile);

Результат:

Полученные файлы:
Array
(
    [file] => Это содержимое тестового файла
)

Полученные поля формы:
Array
(
    [description] => Загрузка через cURL
)

Сервер получил файл и текстовое поле. CURLFile автоматически устанавливает MIME-тип (text/plain) и имя файла.

Пример 4: обработка перенаправлений (redirects) при POST

Иногда сервер после POST отвечает перенаправлением (301/302). cURL по умолчанию не следует за ними, если не включена опция CURLOPT_FOLLOWLOCATION. Но следует учесть, что при перенаправлении POST может превратиться в GET. Для сохранения метода используйте CURLOPT_POSTREDIR.

$url = 'http://example.com/redirect-after-post';
$data = ['action' => 'go'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTREDIR, 3); // 3 = CURL_REDIR_POST_ALL - разрешить замену метода на POST при редиректах
$response = curl_exec($ch);
$finalUrl = curl_getinfo($ch, CURLINFO_EFFECTIVE_URL);
curl_close($ch);

echo "Конечный URL после редиректов: $finalUrl\n";
echo "Ответ:\n$response\n";

Примечание: CURLOPT_POSTREDIR принимает битовую маску: 1 - только 301, 2 - только 302, 3 - оба. Это поведение доступно в PHP 5.3.2+ с libcurl 7.19.0+.

Пример 5: использование прокси-сервера для POST

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

$url = 'https://httpbin.org/post';
$proxy = 'proxy.example.com:8080';
$proxyAuth = 'user:pass';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'value=test');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_PROXY, $proxy);
curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyAuth);
// Если прокси требует NTLM-аутентификацию, можно указать:
// curl_setopt($ch, CURLOPT_PROXYAUTH, CURLAUTH_NTLM);
$response = curl_exec($ch);
if ($response === false) {
    echo 'Ошибка cURL: ' . curl_error($ch);
} else {
    echo 'Ответ через прокси: ' . substr($response, 0, 200) . '...';
}
curl_close($ch);

Важно: не забывайте, что при использовании прокси все данные (включая POST-тело) проходят через него. Для чувствительных данных используйте HTTPS-прокси или шифрование на уровне приложения.

Пример 6: отправка POST с помощью потокового (streaming) тела

Для передачи больших объёмов данных без загрузки всей строки в память можно использовать callback-функцию CURLOPT_READFUNCTION. Пример ниже имитирует передачу данных порциями.

$url = 'https://httpbin.org/post';
$dataChunks = ['часть1 ', 'часть2 ', 'часть3'];
$index = 0;

$readCallback = function($ch, $fd, $length) use (&$dataChunks, &$index) {
    if ($index >= count($dataChunks)) {
        return '';
    }
    $chunk = substr($dataChunks[$index], 0, $length);
    $dataChunks[$index] = substr($dataChunks[$index], strlen($chunk));
    if ($dataChunks[$index] === '') {
        $index++;
    }
    return $chunk;
};

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_PUT, false); // не используем PUT
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_READFUNCTION, $readCallback);
curl_setopt($ch, CURLOPT_INFILESIZE, array_sum(array_map('strlen', $dataChunks)) + strlen(implode('', $dataChunks))); // общий размер тела
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/octet-stream']);
$response = curl_exec($ch);
curl_close($ch);

echo 'Ответ: ' . $response;

Этот пример демонстрирует низкоуровневую работу. На практике для больших файлов проще использовать CURLFile или просто задать строку из файла через file_get_contents, но потоковая передача экономит память.

Пример 7: отправка POST с использованием мультисеансов (curl_multi)

Для параллельной отправки нескольких POST-запросов используется curl_multi_init и curl_multi_exec. Это ускоряет выполнение, когда нужно отправить данные на несколько серверов одновременно.

$urls = [
    'https://httpbin.org/post',
    'https://httpbin.org/post'
];
$data = ['key' => 'value'];

$mh = curl_multi_init();
$channels = [];

foreach ($urls as $i => $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($mh, $ch);
    $channels[$i] = $ch;
}

$active = null;
do {
    $status = curl_multi_exec($mh, $active);
} while ($status === CURLM_CALL_MULTI_PERFORM || $active);

// Получение результатов
foreach ($channels as $i => $ch) {
    $response = curl_multi_getcontent($ch);
    echo "Ответ от запроса $i: " . substr($response, 0, 100) . "...\n";
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);

Результат - два ответа от httpbin.org. Обратите внимание, что в реальной ситуации стоит обрабатывать ошибки каждого отдельного дескриптора.

Пример 8: отправка POST с пользовательскими опциями SSL

Если сервер использует самоподписанный сертификат или устаревший протокол, можно настроить проверку SSL.

$url = 'https://self-signed.badssl.com/post';
$data = ['test' => '1'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Отключаем проверку сертификата (ТОЛЬКО ДЛЯ ТЕСТИРОВАНИЯ!)
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

// Альтернатива - указать путь к CA-пакету (рекомендуется)
// curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem');

$response = curl_exec($ch);
if ($response === false) {
    echo 'SSL ошибка: ' . curl_error($ch);
} else {
    echo 'Ответ получен (проверка SSL отключена) .\n';
}
curl_close($ch);

Предупреждение: отключение проверки SSL делает соединение уязвимым для атак man-in-the-middle. Используйте только в отладочных целях. Для production всегда указывайте валидный CA-пакет через CURLOPT_CAINFO.