Как задать Content-Type в запросах cURL на PHP

Пример 1. Полный цикл отправки JSON с обработкой ответа и проверкой ошибок

$url = 'https://jsonplaceholder.typicode.com/posts';
$data = ['title' => 'foo', 'body' => 'bar', 'userId' => 1];
$jsonData = json_encode($data);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $jsonData,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Accept: application/json'
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30
]);

$response = curl_exec($ch);
$info = curl_getinfo($ch);
$error = curl_error($ch);
curl_close($ch);

if ($error) {
    echo "cURL Error: $error";
} else {
    echo "HTTP Status: {$info['http_code']}\n";
    echo "Response: $response";
}
  

HTTP Status: 201
Response: {
  "title": "foo",
  "body": "bar",
  "userId": 1,
  "id": 101
}
  

Здесь показана полная обработка: проверка на ошибки cURL, получение HTTP-статуса, вывод тела ответа. Установка Accept позволяет серверу вернуть данные в нужном формате.

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

$url = 'https://httpbin.org/post';
$file = new CURLFile('/tmp/test.txt', 'text/plain', 'document.txt');
$fields = ['name' => 'Alice', 'file' => $file];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$decoded = json_decode($response, true);
echo "Form data: " . print_r($decoded['form'], true);
echo "Files: " . print_r($decoded['files'], true);
  

Form data: Array
(
    [name] => Alice
)
Files: Array
(
    [file] => Array
        (
            [name] => document.txt
            [type] => text/plain
            [size] => 100
        )
)
  

Content-Type автоматически стал multipart/form-data; boundary=... . Принудительно изменять его не нужно - cURL сам формирует правильный заголовок.

Пример 3. PUT запрос с JSON данными и переопределением Content-Type

$url = 'https://api.example.com/resource/123';
$data = ['status' => 'updated'];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'If-Match: "abc123"'
    ],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
curl_close($ch);
  

Для PUT запроса используется CURLOPT_CUSTOMREQUEST. Content-Type задаётся через CURLOPT_HTTPHEADER, как и в POST. Важно: не забыть кодировать данные.

Пример 4. Установка Content-Type с кодировкой (charset)

$ch = curl_init('https://example.com/text');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'Простой текст на русском');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: text/plain; charset=utf-8'
]);
$response = curl_exec($ch);
  

Иногда требуется указать кодировку вместе с типом контента. Это делается добавлением параметра charset к значению заголовка. cURL не проверяет корректность кодировки - она просто передаётся на сервер.

Пример 5. Проверка фактического отправленного Content-Type через curl_getinfo

$ch = curl_init('https://httpbin.org/post');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => 'key=value',
    CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded'],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);
// In httpbin response we can see headers sent
echo "Sent Content-Type: " . json_decode($response, true)['headers']['Content-Type'];
  

Sent Content-Type: application/x-www-form-urlencoded
  

Это полезно для отладки: можно убедиться, что заголовок отправлен корректно.