cpp-httplib: 明確な制約を持つ単一ヘッダーのHTTP/HTTPSライブラリ

範囲と明示的な制限

cpp-httplibは、単一のヘッダーファイルとして配布されるC++11ライブラリです。READMEによると、httplib.hをインクルードするだけでセットアップが完了します。サーバーとクライアントの両方の実装を提供し、OpenSSL、MbedTLS、wolfSSLを通じてSSL/TLSをサポートします。このライブラリはブロッキングソケットI/Oを使用し、HTTP/1.1のみを実装しています。HTTP/2とHTTP/3は利用できません。32ビットプラットフォームはサポートされていません。メンテナーは32ビット環境でのセキュリティレビューは行われていないと述べており、32ビットのみに影響するセキュリティレポートは対応せずにクローズされます。リポジトリメタデータには16,719スターと2,723フォークとありますが、README自体は本番環境への適合性を主張していません。 cpp-httplibについてこの章で確認する対象は、READMEの導入例と実際の設定値です。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。READMEの導入例と実際の設定値を確認できない場合、READMEからその性能や互換性を推定しません。

セットアップと最初の例

ライブラリは、httplib.hをプロジェクトに追加することでインクルードされます。サーバーコードはhttplib::Serverまたはhttplib::SSLServerを作成し、Get、Postなどのメソッドでハンドラを登録し、アドレスとポートでリッスンします。クライアントコードはhttplib::Clientまたはhttplib::SSLClientを使用し、Get、Post、Put、Patch、Delete、Optionsなどのメソッドを呼び出します。READMEには、'Hello World!'を返す最小のサーバーと、レスポンスボディを出力するクライアントの例があります。HTTPSの場合、例ではヘッダーをインクルードする前にCPPHTTPLIB_OPENSSL_SUPPORTを定義しています。READMEはビルドシステムやパッケージマネージャーを指定しておらず、単一のファイルを指すだけです。 cpp-httplibについてこの章で確認する対象は、リポジトリのディレクトリ構成と実行コマンドです。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。リポジトリのディレクトリ構成と実行コマンドを確認できない場合、READMEからその性能や互換性を推定しません。

サーバールーティング、静的ファイル、ロギング

サーバーハンドラは、リテラルパス、正規表現、またはreq.path_paramsに代入される:idスタイルのパラメータでパスをマッチできます。ハンドラはヘッダー、クエリパラメータ、ボディコンテンツを読み取れます。サーバーは1つ以上のマウントポイントから静的ファイルを提供でき、ユーザー定義のMIMEタイプマッピングと、一般的な拡張子のための組み込みマッピングをサポートします。READMEは静的ファイルメソッドがスレッドセーフではないと警告しています。アクセスロガーとエラーロガーはset_loggerとset_error_loggerで設定できます。また、プレルーティング、ポストルーティング、プレリクエスト、エラー、例外ハンドラがあり、実行順序が文書化されています。プレリクエストハンドラはルートマッチ後、リクエストボディを読む前に実行されるため、大きなボディをバッファせずにリクエストを拒否できます。 cpp-httplibについてこの章で確認する対象は、設定ファイル、環境変数、入力形式です。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。設定ファイル、環境変数、入力形式を確認できない場合、READMEからその性能や互換性を推定しません。

クライアントリクエスト機能

クライアントはGET、POST、PUT、PATCH、DELETE、OPTIONSをサポートしています。マルチパートフォームデータを送信でき、make_file_providerを使用してファイルをメモリに読み込まずにディスクからアップロードし、make_file_bodyで生のファイルボディを送信できます。認証方法にはBasic、Digest、Bearer Tokenがあり、DigestにはOpenSSLが必要です。プロキシサポートにはBasic、Digest、Bearer Token認証に加え、ワイルドカード、ホスト名サフィックス、IPリテラル、CIDRブロックを受け入れるno-proxyリストがあります。クライアントはリダイレクトに従い、タイムアウトを設定し、ペイロードサイズを制限し、特定のネットワークインターフェースを使用できますが、インターフェース機能はWindowsでは利用できません。READMEのパフォーマンスノートでは、Windowsで'localhost'を使用するとDNSによる遅延が発生する可能性があり、代わりに'127.0.0.1'を使用することを推奨しています。 cpp-httplibについてこの章で確認する対象は、ログ、終了状態、生成される成果物です。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。ログ、終了状態、生成される成果物を確認できない場合、READMEからその性能や互換性を推定しません。

SSL/TLSバックエンドと証明書処理

SSLサポートはプリプロセッサ定義で選択します。CPPHTTPLIB_OPENSSL_SUPPORTはOpenSSL 3.0以降、CPPHTTPLIB_MBEDTLS_SUPPORTはMbed TLS 2.x/3.x/4.x、CPPHTTPLIB_WOLFSSL_SUPPORTは--enable-opensslallでビルドされたwolfSSL 5.x用です。ライブラリは診断用にssl_error()とssl_backend_error()を提供します。カスタム証明書検証はset_server_certificate_verifierで行え、サーバー側ではreq.peer_cert()でピア証明書を検査できます。macOSとWindowsでは、ライブラリはOSの証明書ストアを自動的に統合し、コンパイル時オプションで無効化できます。READMEはSSLに関するSIGPIPE問題に言及しており、シグナルハンドラが必要になる可能性があります。BoringSSLはベストエフォートでサポートされ、既知の差異がいくつかあります。 cpp-httplibについてこの章で確認する対象は、対応範囲とREADMEに明記された制約です。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。対応範囲とREADMEに明記された制約を確認できない場合、READMEからその性能や互換性を推定しません。

ストリーミング、チャンク転送、SSE、WebSocket

サーバーとクライアントの両方がコンテンツレシーバーとプロバイダーをサポートしており、大きなボディをすべてメモリに保持せずにストリーミングできます。チャンク転送エンコーディングは両側で利用でき、トレーラーを送信する機能も含みます。httplib::stream名前空間の別のStream APIはレスポンスをチャンクで処理し、すべてのHTTPメソッドをカバーしています。Server-Sent Eventsは、クライアント側のhttplib::sse::SSEClientとサーバー例で実装されています。WebSocketサポートはサーバーとクライアントにあり、接続ごとに1スレッドを使うモデルで、小規模から中規模のワークロードを対象としています。permessage-deflateなどの拡張は実装されていません。READMEでは、多数の同時WebSocket接続が予想される場合、動的スレッドプールを設定することを推奨しています。 cpp-httplibについてこの章で確認する対象は、リリース欄と対象バージョンです。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。リリース欄と対象バージョンを確認できない場合、READMEからその性能や互換性を推定しません。

リソース制限、圧縮、デプロイメント拡張

デフォルトの最大ペイロードサイズはサーバーとクライアントの両方で100MBで、set_payload_max_lengthまたはコンパイル時のCPPHTTPLIB_PAYLOAD_MAX_LENGTH定義で調整できます。圧縮はzlib、brotli、zstdをサポートし、それぞれに対応する定義があります。デフォルトのAccept-Encodingヘッダーには、サポートされているすべての圧縮タイプが含まれます。サーバーは動的にスケールするスレッドプールを使用し、基本スレッド数は8またはhardware_concurrencyから1を引いた値の大きい方で、最大でその4倍に拡張できます。UnixドメインソケットはLinuxとmacOSで利用できます。split.pyスクリプトはヘッダーを.hと.ccファイルに分割でき、Dockerfileは/htmlから静的ファイルを提供します。このプロジェクトはMITライセンスで、使用、コピー、変更、統合、公開、配布、サブライセンス、販売の権利を許可していますが、ソフトウェアは保証なしで提供されます。 cpp-httplibについてこの章で確認する対象は、READMEの導入例と実際の設定値です。READMEに書かれた操作、入力、依存関係、権限を分けて記録し、結果を説明文の印象で置き換えません。cpp-httplibの利用場面では、まずこの章に対応する項目だけを有効にし、標準出力、標準エラー、生成ファイル、画面上の状態を同じ試行番号に結び付けます。文書にない挙動は保証とみなさず、未記載として扱います。 導入前にはcpp-httplibの対象バージョンと実行環境を固定します。設定を変更した場合は変更前の値を残し、失敗時には同じ入力で再実行して差分を確認します。これにより、cpp-httplib自身の機能、外部サービスの応答、ローカル環境の差を切り分けられます。READMEの導入例と実際の設定値を確認できない場合、READMEからその性能や互換性を推定しません。

編集部の結論

cpp-httplibはHTTPサーバーとクライアントの機能の大部分を1つのヘッダーファイルにまとめ、ブロッキングI/O、HTTP/1.1のみ、32ビット非対応という除外事項も明確にしています。この明確さにより、プロジェクトの要件に合うかを評価しやすくなっています。 cpp-httplibを試す場合は、READMEにあるREADMEの導入例と実際の設定値を使い、入力、終了状態、ログ、生成物を記録してください。cpp-httplibの用途と環境が一致する範囲だけを採用条件にし、文書にない保証は判断材料へ加えません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes