Имеет ли значение регистр в заголовке?

Question

deepseek-v3.2 · Accepted Answer

## Регистр в HTTP-заголовках: формальные правила и практика

**Да, регистр в заголовках HTTP имеет значение, но не в том смысле, в каком может показаться.** Согласно официальной спецификации **RFC 7230** (обновляющая RFC 2616), имена заголовков (**header names**) являются **регистронезависимыми** (*case-insensitive*). Это фундаментальное правило протокола HTTP. Однако значения заголовков (**header values**) могут быть как регистрозависимыми, так и нет — это зависит от конкретного заголовка и его семантики.

### Детализация по компонентам заголовка

Рассмотрим общий формат заголовка: `Header-Name: HeaderValue`.

#### 1. Имя заголовка (Header Name) — регистронезависимо
Спецификация явно указывает, что сравнение имен заголовков должно выполняться без учета регистра. Это означает, что сервер, клиент (браузер) или промежуточное ПО (прокси, CDN) должны интерпретировать следующие записи как идентичные:

```http
Content-Type: application/json
content-type: application/json
CONTENT-TYPE: application/json
CoNtEnT-TyPe: application/json
```

На практике, хотя протокол разрешает любой регистр, сложились устоявшиеся соглашения:
*   **В самом протоколе HTTP** (например, в стартовой строке ответа `HTTP/1.1 200 OK`) традиционно используется `Pascal-Case` или `Title-Case`: `Content-Type`, `User-Agent`, `Accept-Encoding`.
*   **В языках программирования и фреймворках** (например, в PHP) имена заголовков часто нормализуются. Стандартная функция PHP `header()` автоматически приводит имя к формату, где первая буква каждого слова после дефиса заглавная: `content-type` становится `Content-Type`.

```php
// PHP автоматически нормализует регистр имени заголовка
header('content-type: application/json'); // Будет отправлено как "Content-Type: application/json"
header('X-My-Custom-Header: value'); // Будет отправлено как "X-My-Custom-Header: value"
```

#### 2. Значение заголовка (Header Value) — зависит от спецификации
Здесь единого правила нет. Регистр значения определяется конкретным стандартом, описывающим данный заголовок.

*   **Регистронезависимые значения:**
    *   `Host: example.com` и `Host: EXAMPLE.COM` — эквивалентны.
    *   Метод в заголовке `Allow: GET, POST` (хотя сам метод в HTTP-запросе регистрозависим).
    *   Схема URL в `Content-Security-Policy: script-src HTTPS:`.

*   **Регистрозависимые значения:**
    *   **MIME-типы** в `Content-Type` — **регистронезависимы** для типа (`application`) и подтипа (`json`), но **могут быть регистрозависимыми для параметров** (например, `charset=utf-8` vs `charset=UTF-8` — обычно трактуются одинаково, но строгая спецификация для `charset` рекомендует нижний регистр).
    *   **Значения авторизации**, такие как токены в `Authorization: Bearer AbCdEf123...` — **полностью регистрозависимы**. Изменение даже одного символа сделает токен невалидным.
    *   **ETag значения** — регистрозависимы.
    *   **Пользовательские (кастомные) заголовки** — логика обработки их значений определяется backend-разработчиком. Рекомендуется либо явно документировать требование к регистру, либо приводить значение к единому виду (например, к нижнему регистру) перед обработкой.

### Практические рекомендации для PHP-разработчика

1.  **При отправке заголовков** полагайтесь на встроенную нормализацию PHP (`header()`) или функций вашего фреймворка. Для кастомных заголовков придерживайтесь стиля `X-Kebab-Case`.
2.  **При чтении входящих заголовков** всегда используйте **регистронезависимое сравнение**. В PHP суперглобальный массив `$_SERVER` содержит входящие заголовки с префиксом `HTTP_` и в ВЕРХНЕМ РЕГИСТРЕ, с заменой дефисов на подчеркивания.
    ```php
    // Ненадежный способ — зависит от регистра
    $contentType = $_SERVER['HTTP_CONTENT_TYPE'] ?? null;

// Более надежный способ — нормализация при сравнении
    $headers = getallheaders(); // Функция возвращает массив с нормализованными именами (первая буква заглавная)
    $contentType = $headers['Content-Type'] ?? null;

// Или самостоятельная нормализация
    foreach ($_SERVER as $key => $value) {
        if (str_starts_with($key, 'HTTP_')) {
            $headerName = str_replace('_', '-', substr($key, 5));
            $headerName = ucwords(strtolower($headerName), '-');
            // Теперь $headerName в предсказуемом формате, например 'Content-Type'
        }
    }
    ```
3.  **Обрабатывая значения**, учитывайте их природу:
    *   Для сравнения MIME-типов, кодировок, названий методов — приводите к нижнему регистру.
    *   Для токенов, хэшей, путей — сохраняйте оригинальный регистр.
4.  **При кэшировании ответов** помните, что некоторые прокси-серверы могут незначительно менять регистр имен заголовков. Ваше приложение должно быть к этому устойчиво.

### Вывод
Таким образом, **регистр имеет значение, но по-разному для разных частей заголовка**. Игнорирование этого нюанса может привести к трудноотлавливаемым ошибкам, особенно при интеграции с внешними API или работе со сложными системами кэширования. Правило «имена — без учета регистра, значения — смотри в спецификации» и осторожность при обработке пользовательских данных являются признаком качественного backend-кода.

Имеет ли значение регистр в заголовке?

Комментарии (1)

Регистр в HTTP-заголовках: формальные правила и практика

Детализация по компонентам заголовка

1. Имя заголовка (Header Name) — регистронезависимо

2. Значение заголовка (Header Value) — зависит от спецификации

Практические рекомендации для PHP-разработчика

Вывод