cpp-httplib/docs-src/pages/ja/cookbook/s08-compress-response.md

---

title: "S08. レスポンスを圧縮して返す" order: 27

status: "draft"

cpp-httplibは、クライアントがAccept-Encodingで対応を表明していれば、レスポンスボディを自動で圧縮してくれます。ハンドラ側で特別なことをする必要はありません。対応しているのはgzip、Brotli、Zstdです。

ビルド時の準備

圧縮機能を使うには、httplib.hをインクルードする前に対応するマクロを定義しておきます。

#define CPPHTTPLIB_ZLIB_SUPPORT     // gzip
#define CPPHTTPLIB_BROTLI_SUPPORT   // brotli
#define CPPHTTPLIB_ZSTD_SUPPORT     // zstd
#include <httplib.h>

それぞれzlib、brotli、zstdをリンクする必要があります。必要な圧縮方式だけ有効にすればOKです。

使い方

svr.Get("/api/data", [](const httplib::Request &req, httplib::Response &res) {
  std::string body = build_large_response();
  res.set_content(body, "application/json");
});

これだけです。クライアントがAccept-Encoding: gzipを送ってきていれば、cpp-httplibが自動でgzip圧縮して返します。レスポンスにはContent-Encoding: gzipとVary: Accept-Encodingが自動で付きます。

圧縮の優先順位

クライアントが複数の方式を受け入れる場合、Brotli → Zstd → gzipの順に選ばれます（ビルドで有効になっている中から）。クライアント側では気にせず、一番効率の良い方式で圧縮されます。

ストリーミングレスポンスも圧縮される

set_chunked_content_provider()で返すストリーミングレスポンスも、同じように自動で圧縮されます。

svr.Get("/events", [](const httplib::Request &req, httplib::Response &res) {
  res.set_chunked_content_provider(
    "text/plain",
    [](size_t offset, httplib::DataSink &sink) {
      // ...
    });
});

静的ファイルは明示的に有効にする

set_mount_point()やResponse::set_file_content()でファイルをそのまま返す場合、デフォルトでは圧縮されません。有効にするには次を呼びます。

svr.set_static_file_compression(true);

圧縮の対象になるのは一定のサイズ範囲に収まるファイルだけで、上下どちらの境界も変更できます。

svr.set_static_file_compression_min_length(512);
svr.set_static_file_compression_max_length(1024 * 1024);

下限のデフォルトは1400バイトです。1500バイトのMTUに収まるレスポンスは、小さくしたところで到達が速くなるわけではありません。さらに数バイトのファイルは、gzipのヘッダとトレーラがdeflateの削減分を上回るため、かえって大きくなって返ります。

上限のデフォルトは4MBで、こちらは理由が違います。リクエストのたびに圧縮が走り、圧縮後のバイト列はレスポンスを書き終えるまでメモリに載るため、ピーク時のコストが同時処理中のリクエスト数に比例するからです。つまり1リクエストあたりのコストを抑えるための値であって、大きいファイルは圧縮しても無駄だという意味ではありません。配信するファイルが分かっていてトラフィックがそれほど多くないなら、引き上げて構いません。

どちらの境界も0で無効にできます。コンパイル時のデフォルトはCPPHTTPLIB_STATIC_FILE_COMPRESSION_MIN_LENGTHとCPPHTTPLIB_STATIC_FILE_COMPRESSION_MAX_LENGTHで決まります。

圧縮してもContent-Lengthは付いたままなので、HEADはGETと同じサイズを返します。細かい挙動として、Rangeリクエストは非圧縮の表現から切り出して返し、ETagにはW/"...-gzip"のように使われた圧縮方式が入ります。

なおset_content_provider()で登録したコンテンツプロバイダは対象外です。圧縮器を通すと、内部バッファが埋まるまで書き込みが送出されず、ボディを少しずつ生成するプロバイダが止まってしまうためです。生成したボディを圧縮したい場合はset_chunked_content_provider()を使ってください。

Note: サイズ範囲が効くのは静的ファイルだけです。set_content()に渡したボディは、圧縮対象のMIMEタイプでクライアントが受け入れていれば、大きさによらず圧縮されます。数バイトのレスポンスはgzipのヘッダ分だけかえって大きくなるので、避けたい場合はハンドラ側で判断してください。

クライアント側の挙動はC15. 圧縮を有効にするを参照してください。