Как отправить POST-запрос с помощью PHP: curl, file_get_contents и другие способы

Основные способы отправки POST-запросов в PHP

В PHP есть два основных подхода для отправки POST-запросов: cURL (рекомендуемый) и file_get_contents() с контекстом потока. Мы разберём оба, но начнём с cURL, так как он даёт больше контроля и надёжности.

1. Использование cURL (рекомендуемый способ)

cURL — это мощная библиотека для работы с HTTP-запросами. Вот базовый пример отправки POST-запроса с JSON-данными:

<?php
$url = 'https://example.com/api/users';
$data = ['name' => 'Иван', 'email' => 'ivan@example.com'];

$ch = curl_init($url);

// Настройка параметров запроса
curl_setopt_array($ch, [
    CURLOPT_POST => true,                                   // Метод POST
    CURLOPT_POSTFIELDS => json_encode($data),               // Тело запроса
    CURLOPT_HTTPHEADER => [                                 // Заголовки
        'Content-Type: application/json',
        'Content-Length: ' . strlen(json_encode($data))
    ],
    CURLOPT_RETURNTRANSFER => true,                         // Вернуть ответ как строку
    CURLOPT_TIMEOUT => 30,                                  // Таймаут в секундах
    CURLOPT_SSL_VERIFYPEER => true,                         // Проверка SSL-сертификата
]);

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

curl_close($ch);

if ($error) {
    echo "Ошибка cURL: $error";
} elseif ($httpCode >= 200 && $httpCode < 300) {
    echo "Успешно! Ответ: " . $response;
} else {
    echo "HTTP ошибка: $httpCode. Ответ: " . $response;
}
?>

Ключевые моменты:

• CURLOPT_POST — включает метод POST
• CURLOPT_POSTFIELDS — принимает строку (для JSON) или массив (для form-data)
• CURLOPT_RETURNTRANSFER — возвращает ответ в переменную, а не выводит сразу
• Всегда проверяйте HTTP-код ответа и ошибки cURL

2. Отправка form-data (application/x-www-form-urlencoded)

Если нужно отправить данные как обычную HTML-форму:

<?php
$data = ['name' => 'Иван', 'email' => 'ivan@example.com'];

$ch = curl_init('https://example.com/api/users');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($data),  // Преобразует массив в строку запроса
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
curl_close($ch);
?>

3. Отправка multipart/form-data (с файлами)

Для загрузки файлов используйте массив с указанием пути к файлу:

<?php
$data = [
    'name' => 'Иван',
    'avatar' => new CURLFile('/path/to/avatar.jpg', 'image/jpeg', 'avatar.jpg')
];

$ch = curl_init('https://example.com/api/upload');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,  // Массив — curl сам установит multipart/form-data
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
curl_close($ch);
?>

4. Добавление авторизации (Bearer Token, Basic Auth)

<?php
$token = 'your_bearer_token_here';

$ch = curl_init('https://example.com/api/protected');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['action' => 'get_data']),
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token,
    ],
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
curl_close($ch);
?>

5. Альтернатива: file_get_contents() с контекстом

Ваш первоначальный код близок к правильному, но есть нюансы. Вот исправленная версия:

<?php
$url = 'https://example.com/api/users';
$data = ['name' => 'Иван', 'email' => 'ivan@example.com'];
$jsonData = json_encode($data);

$options = [
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/json\r\n" .
                     "Content-Length: " . strlen($jsonData) . "\r\n",
        'content' => $jsonData,
        'ignore_errors' => true  // Важно! Позволяет получить ответ даже при HTTP ошибках
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);

if ($result === false) {
    $error = error_get_last();
    echo "Ошибка: " . $error['message'];
} else {
    echo "Ответ: " . $result;
}
?>

Почему cURL лучше:

• Лучшая обработка ошибок (коды ответа, таймауты)
• Поддержка HTTPS, прокси, кук, редиректов
• Работа с файлами (multipart/form-data)
• Больше контроля над заголовками и параметрами

Для простых запросов можно использовать file_get_contents(), но для production-кода всегда выбирайте cURL.

composer require guzzlehttp/guzzle

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://example.com',
    'timeout'  => 10.0,
]);

try {
    $response = $client->post('/api/users', [
        'json' => [
            'name' => 'Иван',
            'email' => 'ivan@example.com'
        ],
        'headers' => [
            'Authorization' => 'Bearer your_token'
        ]
    ]);

    $body = $response->getBody()->getContents();
    $statusCode = $response->getStatusCode();
    
    echo "Статус: $statusCode, Ответ: $body";
    
} catch (\GuzzleHttp\Exception\ClientException $e) {
    echo "HTTP ошибка: " . $e->getResponse()->getStatusCode();
    echo "Тело ошибки: " . $e->getResponse()->getBody();
} catch (\GuzzleHttp\Exception\ConnectException $e) {
    echo "Ошибка соединения: " . $e->getMessage();
}
?>