Способы отправки защищенных POST запросов в PHP

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

Пример 1: Отправка JSON данных с помощью cURL

Для работы с REST API часто требуется передавать данные в формате JSON. В cURL устанавливается заголовок Content-Type и тело кодируется через json_encode.

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

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($jsonData)
]);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
    echo 'Ошибка: ' . curl_error($ch);
} else {
    echo 'HTTP код: ' . $httpCode . "\n";
    echo 'Ответ: ' . $response;
}
curl_close($ch);
?>

HTTP код: 201
Ответ: {"id":123,"name":"John","email":"john@example.com"}

Пример 2: Отправка формы (multipart/form-data) с файлом

Для загрузки файла используется CURLFile. Вектор CURLOPT_POSTFIELDS принимает массив, в котором элемент файла - экземпляр CURLFile.

<?php
$url = 'https://example.com/upload';
$filePath = '/path/to/file.pdf';
$cfile = new CURLFile($filePath, 'application/pdf', 'file.pdf');

$postData = [
    'user_id' => 42,
    'document' => $cfile
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
    echo 'Ошибка загрузки: ' . curl_error($ch);
} else {
    echo 'Код: ' . $httpCode;
    echo 'Ответ: ' . $response;
}
curl_close($ch);
?>

Код: 200
Ответ: {"status":"ok","file_id":789}

Пример 3: Установка пользовательских заголовков и таймаутов

При работе с внешними API часто требуются специальные заголовки (API ключи, User-Agent). Таймауты предотвращают зависание скрипта.

<?php
$url = 'https://api.example.com/verify';
$data = ['token' => 'abc123'];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer your_api_key_here',
    'User-Agent: MyApp/1.0',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);  // таймаут соединения 5 сек
curl_setopt($ch, CURLOPT_TIMEOUT, 10);        // общий таймаут 10 сек
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Ошибка: ' . curl_error($ch);
} else {
    echo $response;
}
curl_close($ch);
?>

{"status":"valid","message":"Token is valid."}

Пример 4: Использование прокси

Для обхода ограничений или тестирования можно отправить запрос через HTTP/HTTPS прокси. Настройка через CURLOPT_PROXY и CURLOPT_PROXYPORT.

<?php
$url = 'https://httpbin.org/post';
$proxy = '127.0.0.1:8888';  // локальный прокси

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'test=1');
curl_setopt($ch, CURLOPT_PROXY, $proxy);
curl_setopt($ch, CURLOPT_PROXYPORT, 8888);
curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, true); // для HTTPS через прокси
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Ошибка прокси: ' . curl_error($ch);
} else {
    echo $response;
}
curl_close($ch);
?>

{
  "args": {},
  "data": "",
  "files": {},
  "form": {
    "test": "1"
  },
  "headers": {
    "Host": "httpbin.org",
    ...
  },
  "method": "POST",
  "origin": "x.x.x.x"
}

Пример 5: Аутентификация Basic Auth через cURL

Для доступа к защищённым ресурсам с помощью HTTP Basic Auth используется опция CURLOPT_USERPWD.

<?php
$url = 'https://api.example.com/secure';
$username = 'admin';
$password = 'secret';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'action=login');
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Ошибка: ' . curl_error($ch);
} else {
    echo $response;
}
curl_close($ch);
?>

{"status":"authorized","data":"..."}

Пример 6: Отправка POST запроса с помощью Guzzle и обработка HTTP ошибок

Guzzle выбрасывает исключения для HTTP ошибок 4xx/5xx, если не включён специальный режим. В примере перехватываются разные типы исключений.

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

use GuzzleHttp\Client;
use GuzzleHttp\Exception\ClientException;
use GuzzleHttp\Exception\ServerException;
use GuzzleHttp\Exception\ConnectException;

$client = new Client(['base_uri' => 'https://httpbin.org', 'verify' => true]);

try {
    $response = $client->post('/post', [
        'headers' => ['X-Custom' => 'test'],
        'form_params' => ['key' => 'value']
    ]);
    echo $response->getBody();
} catch (ClientException $e) {
    echo 'Клиентская ошибка (4xx): ' . $e->getMessage() . "\n";
    if ($e->hasResponse()) {
        echo 'Тело ответа: ' . $e->getResponse()->getBody();
    }
} catch (ServerException $e) {
    echo 'Серверная ошибка (5xx): ' . $e->getMessage();
} catch (ConnectException $e) {
    echo 'Ошибка соединения: ' . $e->getMessage();
} catch (Exception $e) {
    echo 'Другая ошибка: ' . $e->getMessage();
}
?>

{
  "args": {},
  "data": "",
  "files": {},
  "form": {
    "key": "value"
  },
  "headers": {
    "Host": "httpbin.org",
    "X-Custom": "test"
  },
  "method": "POST",
  "origin": "x.x.x.x"
}