HTTPS запросы с cURL в PHP: настройка, варианты, примеры

Расширенные примеры работы cURL с HTTPS

1. POST запрос с JSON через HTTPS и проверкой сертификата

$url = 'https://httpbin.org/post';
$data = json_encode(['key' => 'value']);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

HTTP 200
Response body: {
  "json": {"key": "value"},
  ...
}

2. Аутентификация по сертификату клиента (mutual TLS)

$ch = curl_init('https://secure.example.com/api');
curl_setopt_array($ch, [
    CURLOPT_SSLCERT => '/path/to/client.crt',
    CURLOPT_SSLCERTPASSWD => 'password123',
    CURLOPT_SSLKEY => '/path/to/client.key',
    CURLOPT_SSLKEYPASSWD => 'keypassword',
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/path/to/ca.crt',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

Результат: успешное соединение только при наличии валидного клиентского сертификата и ключа.

3. Получение заголовков ответа при HTTPS

$ch = curl_init('https://api.github.com');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => true, // включить заголовки в вывод
    CURLOPT_NOBODY => false, // получить тело
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
    CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; PHP cURL)'
]);
$response = curl_exec($ch);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headers = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);
curl_close($ch);
echo $headers;

HTTP/2 200
server: GitHub.com
content-type: application/json; charset=utf-8
...

4. Загрузка файла через HTTPS с сохранением на диск

$url = 'https://example.com/file.zip';
$destination = '/tmp/file.zip';
$fp = fopen($destination, 'w');
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_FILE => $fp,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
    CURLOPT_FOLLOWLOCATION => true, // следовать редиректам
]);
curl_exec($ch);
curl_close($ch);
fclose($fp);
echo 'Файл загружен: ' . filesize($destination) . ' байт';

Файл загружен: 1048576 байт

5. Обработка ошибок SSL с помощью curl_error и curl_errno

$ch = curl_init('https://self-signed.badssl.com/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
]);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Ошибка (' . curl_errno($ch) . '): ' . curl_error($ch);
} else {
    echo 'Успех';
}
curl_close($ch);

Ошибка (60): SSL certificate problem: self signed certificate

6. Использование CURLOPT_RESOLVE для принудительного разрешения IP с SNI

$ch = curl_init('https://github.com');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
    CURLOPT_RESOLVE => [
        'github.com:443:140.82.121.3' // IP сервера
    ],
]);
$response = curl_exec($ch);

Этот пример принудительно разрешает имя github.com в IP 140.82.121.3, сохраняя SNI для корректного SSL рукопожатия.

7. Проверка цепочки сертификатов с помощью CURLOPT_SSL_VERIFYSTATUS (Experimental)

// Требует OpenSSL >= 1.0.2 и cURL, собранный с поддержкой OCSP
$ch = curl_init('https://example.com');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => '/etc/ssl/certs/ca-certificates.crt',
    CURLOPT_SSL_VERIFYSTATUS => true, // проверка отзыва по OCSP
]);
$response = curl_exec($ch);

При ошибке OCSP: SSL: certificate status verification failed. Используется редко, но для критичных систем может быть полезно.