POST-запросы в PHP с cURL: гайд 2025 года

Онлайн-тренажер Python для начинающих

Изучайте Python легко и без перегрузки теорией. Решайте практические задачи с автоматической проверкой, получайте подсказки на русском языке и пишите код прямо в браузере — без необходимости что-либо устанавливать.

Начать курс

PHP, cURL и HTTP POST: как отправлять данные как профи в 2025 году

Если вы когда-нибудь писали код на PHP, который должен был "поговорить" с другим сервером — отправить форму, вызвать API или просто передать данные — вы наверняка сталкивались с cURL. Это не просто библиотека, это швейцарский нож для HTTP-запросов. И хотя в 2025 году у нас есть более современные инструменты вроде Guzzle или Symfony HttpClient, cURL остаётся фундаментом, который нужно знать каждому PHP-разработчику.

Вопрос "PHP, cURL, and HTTP POST example?" на Stack Overflow собрал тысячи просмотров. Почему? Потому что это та самая задача, которая встречается в каждом втором проекте: от интеграции с платёжными системами до отправки данных в CRM. Давайте разберёмся, как делать это правильно, безопасно и красиво.

Что такое cURL и зачем он нужен в PHP?

cURL (Client URL) — это мощная библиотека, которая позволяет вашему PHP-скрипту выступать в роли HTTP-клиента. Представьте, что ваш код — это браузер без интерфейса. Он может открывать страницы, отправлять формы, скачивать файлы и даже работать с куками.

В 2025 году cURL остаётся актуальным, потому что:

Он встроен в PHP (не нужно устанавливать дополнительные пакеты)
Работает быстрее некоторых "тяжёлых" библиотек
Даёт полный контроль над каждым аспектом запроса
Поддерживает все современные протоколы: HTTP/2, HTTPS, FTP и даже IMAP

Базовый пример: отправляем POST-запрос с cURL

Давайте начнём с классики. Вот минимальный рабочий код, который отправляет POST-запрос на сервер:

<?php
// URL, куда отправляем данные
$url = 'https://api.example.com/submit';

// Данные для отправки (ассоциативный массив)
$postData = [
    'name' => 'Иван Петров',
    'email' => 'ivan@example.com',
    'message' => 'Привет из 2025 года!'
];

// Инициализация cURL
$ch = curl_init($url);

// Настройки запроса
curl_setopt_array($ch, [
    CURLOPT_POST => true,                          // Это POST-запрос
    CURLOPT_POSTFIELDS => http_build_query($postData), // Данные в формате строки
    CURLOPT_RETURNTRANSFER => true,                // Вернуть ответ как строку
    CURLOPT_HEADER => false,                       // Не возвращать заголовки
    CURLOPT_TIMEOUT => 30,                         // Таймаут 30 секунд
    CURLOPT_SSL_VERIFYPEER => true,                // Проверять SSL-сертификат
]);

// Выполняем запрос
$response = curl_exec($ch);

// Проверка на ошибки
if (curl_errno($ch)) {
    echo 'Ошибка cURL: ' . curl_error($ch);
} else {
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "HTTP-код ответа: $httpCode\n";
    echo "Тело ответа: $response";
}

// Закрываем соединение
curl_close($ch);
?>

Обратите внимание на http_build_query(). Это удобная функция, которая превращает массив в URL-encoded строку. Без неё cURL может неправильно обработать данные.

Отправка JSON вместо формы

В 2025 году большинство API работают с JSON, а не с классическими POST-формами. Вот как адаптировать наш пример:

<?php
$url = 'https://api.example.com/v2/users';
$jsonData = json_encode([
    'username' => 'developer_2025',
    'password' => 'secret_password',
    'role' => 'admin'
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $jsonData,  // Отправляем сырой JSON
    CURLOPT_HTTPHEADER => [           // Важно: указываем заголовки
        'Content-Type: application/json',
        'Content-Length: ' . strlen($jsonData),
        'Accept: application/json'
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
    echo "Пользователь успешно создан!";
} else {
    echo "Ошибка $httpCode: $response";
}
?>

Ключевое отличие — мы сами задаём заголовок Content-Type: application/json. Без этого сервер может не понять, что вы отправили JSON.

Обработка ошибок: не дайте вашему коду упасть

Одна из самых частых ошибок новичков — игнорирование проверок. Вот как должен выглядеть профессиональный подход:

<?php
function sendPostRequest(string $url, array $data): array {
    $ch = curl_init();
    
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query($data),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_CONNECTTIMEOUT => 5, // Таймаут соединения
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_SSL_VERIFYHOST => 2, // Проверка имени хоста
        CURLOPT_FOLLOWLOCATION => true, // Следовать редиректам
        CURLOPT_MAXREDIRS => 3,        // Максимум редиректов
    ]);
    
    $response = curl_exec($ch);
    $error = curl_error($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $info = curl_getinfo($ch);
    curl_close($ch);
    
    if ($error) {
        return [
            'success' => false,
            'error' => "cURL error: $error",
            'http_code' => 0
        ];
    }
    
    return [
        'success' => $httpCode >= 200 && $httpCode < 300,
        'http_code' => $httpCode,
        'body' => $response,
        'info' => $info
    ];
}

// Использование
$result = sendPostRequest('https://api.example.com/data', ['key' => 'value']);
if ($result['success']) {
    $data = json_decode($result['body'], true);
    // Работаем с данными
} else {
    error_log("API error: {$result['error']}");
}
?>

Обратите внимание на CURLOPT_CONNECTTIMEOUT — он отвечает за время ожидания соединения, а CURLOPT_TIMEOUT — за весь запрос. В эпоху медленных серверов это спасёт ваш скрипт от зависания.