Работа с заголовками HTTP запроса: получение данных средствами PHP

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

Ниже приведены примеры, которые демонстрируют более сложные сценарии: фильтрация, сериализация, логирование и интеграция с другими компонентами.

Пример 1. Фильтрация заголовков по префиксу

Этот пример извлекает только заголовки, начинающиеся с X- (пользовательские заголовки). Это полезно для обработки кастомных метаданных.

$allHeaders = getallheaders();
$xHeaders = array_filter($allHeaders, function($key) {
    return strpos($key, 'X-') === 0;
}, ARRAY_FILTER_USE_KEY);
print_r($xHeaders);

Array
(
    [X-Request-Id] => abc123
    [X-Custom] => value
)

Пример 2. Преобразование всех заголовков в JSON для логирования

При отладке или аудите удобно сохранять заголовки в формате JSON.

$headers = getallheaders();
$jsonHeaders = json_encode($headers, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
error_log("Request headers: " . $jsonHeaders);
echo $jsonHeaders;

{
    "Host": "example.com",
    "User-Agent": "Mozilla/5.0",
    "Accept": "text/html"
}

Пример 3. Проверка наличия обязательного заголовка с выдачей ошибки

В API часто требуется проверка заголовка Content-Type или Authorization.

$contentType = $_SERVER['CONTENT_TYPE'] ?? '';
if (stripos($contentType, 'application/json') === false) {
    http_response_code(415);
    echo json_encode(['error' => 'Unsupported Media Type']);
    exit;
}
echo 'Content-Type validated successfully.';

Пример 4. Извлечение заголовков с использованием cURL в роли клиента

Иногда PHP выступает в роли HTTP клиента и отправляет запросы. Пример получения заголовков ответа (не запроса) с помощью cURL.

$ch = curl_init('https://api.example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);
$response = curl_exec($ch);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headerStr = substr($response, 0, $headerSize);
$headers = explode("\r\n", trim($headerStr));
print_r($headers);
curl_close($ch);

Array
(
    [0] => HTTP/1.1 200 OK
    [1] => Content-Type: application/json
    [2] => Date: Mon, 01 Jan 2024 00:00:00 GMT
    ...
)

Пример 5. Обработка заголовков с одинаковыми именами

Некоторые заголовки (например, Set-Cookie) могут повторяться. getallheaders() в этом случае возвращает только последнее значение. Для получения всех значений требуется парсинг сырых заголовков.

$rawHeaders = getallheaders();
// getallheaders не поддерживает множественные значения, поэтому используем $_SERVER с осторожностью
// Альтернативный подход: получить строку заголовков через apache_response_headers()? Нет, это для ответа.
// Для запроса множественные значения можно получить через explode на основе 
// but PHP не сохраняет исходный порядок. Лучше использовать модуль Apache или Nginx с сохранением.
// Простой неполный пример: искать через preg_match_all на сыром HTTP запросе (только если доступен)
// Однако в рамках PHP это сложно. Обычно рекомендуется обрабатывать как единую строку.

При необходимости работы с двойными заголовками (например, Cookie) стоит применить ручной разбор $_SERVER с учётом возможных дубликатов (через array_count_values и array_keys).

Пример 6. Создание обёртки для получения заголовков с автодополнением недостающих

Пользовательская функция, которая объединяет все источники и гарантированно возвращает массив.

function getRequestHeaders(): array {
    if (function_exists('getallheaders')) {
        return getallheaders();
    }
    if (function_exists('apache_request_headers')) {
        return apache_request_headers();
    }
    $headers = [];
    $specialHeaders = ['CONTENT_TYPE', 'CONTENT_LENGTH', 'CONTENT_MD5'];
    foreach ($_SERVER as $key => $value) {
        if (substr($key, 0, 5) === 'HTTP_') {
            $headerName = str_replace('_', '-', substr($key, 5));
            $headerName = implode('-', array_map('ucfirst', explode('-', strtolower($headerName))));
            $headers[$headerName] = $value;
        } elseif (in_array($key, $specialHeaders)) {
            $headers[$key] = $value;
        }
    }
    return $headers;
}

$headers = getRequestHeaders();
var_dump($headers);

array(4) {
  ["Host"] => string(11) "example.com"
  ["User-Agent"] => string(10) "Mozilla/5.0"
  ["Accept"] => string(9) "text/html"
  ["Content-Type"] => string(9) "text/html"
}

Эта обёртка подходит для большинства окружений и легко расширяема.