HTTP-заголовок Content-Encoding представления перечисляет способы кодирования и порядок их применения к ресурсу. Это позволяет получателю узнать, как декодировать данные, чтобы получить исходный формат содержимого, описанный в заголовке Content-Type. Кодирование содержимого в основном используется для сжатия данных без потери информации об исходном типе мультимедиа.

Серверы должны максимально сжимать данные и использовать кодирование содержимого, когда это уместно. Обычно не следует сжимать уже сжатые типы мультимедиа, такие как .zip или .jpeg, поскольку это может увеличить размер файла. Если исходные данные уже закодированы (например, представлены в виде файла .zip), эти сведения не включаются в заголовок Content-Encoding.

Если присутствует заголовок Content-Encoding, другие метаданные (например, Content-Length) относятся к закодированной форме данных, а не к исходному ресурсу, если явно не указано иное. Кодирование содержимого отличается от Transfer-Encoding: Transfer-Encoding определяет, как сами HTTP-сообщения передаются по сети от узла к узлу.

Синтаксис

Content-Encoding: gzip
Content-Encoding: compress
Content-Encoding: deflate
Content-Encoding: br
Content-Encoding: zstd
Content-Encoding: dcb
Content-Encoding: dcz

// Multiple, in the order in which they were applied
Content-Encoding: deflate, gzip

Директивы

gzip

Формат, использующий кодирование Лемпеля — Зива (LZ77) с 32-битной контрольной суммой CRC. Это исходный формат программы gzip для UNIX. В стандарте HTTP/1.1 также рекомендуется, чтобы серверы, поддерживающие это кодирование содержимого, распознавали x-gzip как псевдоним для обеспечения совместимости.

compress

Формат, использующий алгоритм Лемпеля — Зива — Велча (LZW). Название значения взято от программы compress для UNIX, в которой был реализован этот алгоритм. Подобно программе compress, исчезнувшей из большинства дистрибутивов UNIX, это кодирование содержимого сегодня используется немногими браузерами — отчасти из-за патентных ограничений (патент истёк в 2003 году).

deflate

Использует структуру zlib (определённую в RFC 1950) с алгоритмом сжатия deflate (определённым в RFC 1951).

br

Формат, использующий структуру алгоритма Brotli (определённую в RFC 7932).

zstd

Формат, использующий структуру алгоритма Zstandard (определённую в RFC 8878).

dcb

Формат, использующий алгоритм Brotli со сжатием по словарю. См. раздел Транспорт словарей сжатия.

dcz

Формат, использующий алгоритм Zstandard со сжатием по словарю. См. раздел Транспорт словарей сжатия.

Примеры

Сжатие с помощью gzip

На стороне клиента можно указать список схем сжатия, которые будут переданы в HTTP-запросе. Для согласования кодирования содержимого используется заголовок Accept-Encoding.

Accept-Encoding: gzip, deflate

Сервер сообщает использованную схему в заголовке ответа Content-Encoding.

Content-Encoding: gzip

Использует ли сервер запрошенные клиентом методы сжатия, зависит от конфигурации и возможностей сервера.

Спецификации

Совместимость с браузерами

См. также

• Accept-Encoding
• Transfer-Encoding
• Сжатие Brotli
• Сжатие GZip
• Сжатие Zstandard
• Руководство по передаче словарей сжатия