Выполнение POST запроса из PHP: обзор эффективных решений

// Простой POST запрос с application/x-www-form-urlencoded
$url = 'https://httpbin.org/post';
$data = ['name' => 'Анна', 'age' => 28];

$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);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    $error = 'Ошибка cURL: ' . curl_error($ch);
} else {
    // Успешный ответ
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
}
curl_close($ch);
  

$url = 'https://httpbin.org/post';
$data = http_build_query(['key1' => 'value1', 'key2' => 'value2']);
$options = [
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $data
    ]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
if ($result === false) {
    // Обработка ошибки
    echo 'Ошибка выполнения запроса';
}
  

$host = 'httpbin.org';
$path = '/post';
$data = 'param1=value1¶m2=value2';

$fp = fsockopen($host, 80, $errno, $errstr, 10);
if (!$fp) {
    echo "Ошибка: $errstr ($errno)";
} else {
    $request = "POST $path HTTP/1.1\r\n";
    $request .= "Host: $host\r\n";
    $request .= "Content-Type: application/x-www-form-urlencoded\r\n";
    $request .= "Content-Length: " . strlen($data) . "\r\n";
    $request .= "Connection: close\r\n\r\n";
    $request .= $data;

    fwrite($fp, $request);
    $response = '';
    while (!feof($fp)) {
        $response .= fgets($fp, 1024);
    }
    fclose($fp);
    // Здесь можно разобрать ответ (заголовки и тело)
}
  

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();
$response = $client->post('https://httpbin.org/post', [
    'form_params' => [
        'username' => 'ivan',
        'password' => 'secret'
    ]
]);
$body = $response->getBody()->getContents();
$statusCode = $response->getStatusCode();
  

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

1. Отправка JSON через cURL с обработкой ответа

Часто API принимает данные в формате JSON. Передаём строку JSON и устанавливаем соответствующий заголовок.

$url = 'https://api.example.com/users';
$data = ['name' => 'Елена', 'role' => 'admin'];
$json = json_encode($data);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $json,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Accept: application/json'
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// Предполагаем, что ответ в JSON
$decoded = json_decode($response, true);
if ($httpCode === 200) {
    // Успешная обработка
    echo 'ID пользователя: ' . $decoded['id'];
} else {
    // Ошибка
    echo 'Ошибка: ' . ($decoded['error'] ?? 'Неизвестная');
}

ID пользователя: 42

2. Отправка файла (multipart/form-data) через cURL

Для загрузки файлов используется класс CURLFile или синтаксис с @ (устарел).

$url = 'https://example.com/upload';
$file = new CURLFile('/path/to/image.jpg', 'image/jpeg', 'avatar.jpg');
$data = ['file' => $file, 'description' => 'Аватар пользователя'];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);

Пояснение: cURL автоматически устанавливает заголовок multipart/form-data при передаче массива с объектами CURLFile. Важно указывать полный путь к файлу.

{"success": true, "file_url": "https://example.com/uploads/avatar.jpg"}

3. POST запрос с базовой аутентификацией и таймаутами

Добавляем заголовок Authorization или используем опции cURL для Basic Auth.

$url = 'https://api.example.com/secure';
$username = 'client';
$password = 'secret123';
$data = ['grant_type' => 'client_credentials'];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_HTTPAUTH => CURLAUTH_BASIC,
    CURLOPT_USERPWD => "$username:$password",
    CURLOPT_TIMEOUT => 30,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);

Установка таймаутов предотвращает зависание скрипта при недоступности сервера.

4. POST с использованием контекста stream и HTTPS с самоподписанным сертификатом

При работе с внутренними серверами может потребоваться отключение проверки сертификата.

$url = 'https://self-signed.example.com/api';
$data = http_build_query(['action' => 'test']);
$options = [
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $data,
        'timeout' => 15
    ],
    'ssl' => [
        'verify_peer' => false,
        'verify_peer_name' => false,
        'allow_self_signed' => true
    ]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);

Внимание:

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

5. Асинхронный POST с Guzzle (на основе промисов)

Guzzle поддерживает асинхронные запросы, позволяя отправлять несколько запросов параллельно.

require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Promise;

$client = new Client();

$promises = [
    'user1' => $client->postAsync('https://api.example.com/login', [
        'form_params' => ['user' => 'alice', 'pass' => '123']
    ]),
    'user2' => $client->postAsync('https://api.example.com/login', [
        'form_params' => ['user' => 'bob', 'pass' => '456']
    ])
];

$results = Promise\settle($promises)->wait();

foreach ($results as $key => $result) {
    if ($result['state'] === 'fulfilled') {
        $response = $result['value'];
        echo "$key: статус " . $response->getStatusCode() . "\n";
    } else {
        echo "$key: ошибка " . $result['reason'] . "\n";
    }
}

Пояснение: методы postAsync возвращают промисы. Promise\settle ожидает выполнения всех промисов и возвращает массив с результатами. Это эффективно для массовой рассылки или опроса множества эндпоинтов.

6. Отправка POST через сокет с использованием SSL (HTTPS)

Для HTTPS необходимо открыть сокет с префиксом ssl://.

$host = 'api.example.com';
$path = '/data';
$data = 'field1=value1';

$fp = stream_socket_client('ssl://' . $host . ':443', $errno, $errstr, 30);
if (!$fp) {
    echo "Ошибка: $errstr ($errno)";
} else {
    $request = "POST $path HTTP/1.1\r\n";
    $request .= "Host: $host\r\n";
    $request .= "Content-Type: application/x-www-form-urlencoded\r\n";
    $request .= "Content-Length: " . strlen($data) . "\r\n";
    $request .= "Connection: close\r\n\r\n";
    $request .= $data;

    fwrite($fp, $request);
    $response = stream_get_contents($fp);
    fclose($fp);
    // Разделяем заголовки и тело
    list($headers, $body) = explode("\r\n\r\n", $response, 2);
}

Пояснение: stream_socket_client создаёт зашифрованное соединение. Дальше работа аналогична HTTP-сокету.