mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-10-13 14:53:18 +00:00
885ed54b10
Drop the spaces between Japanese text and inline code or alphanumerics in the tour and the few other pages that still had them, and reword sentences that read awkwardly. The client compression page now lists Zstd alongside zlib and Brotli.
2.3 KiB
2.3 KiB
title, order, status
| title | order | status |
|---|---|---|
| S04. 静的ファイルサーバーを設定する | 23 | draft |
HTML、CSS、画像などの静的ファイルを配信したいときは、set_mount_point()を使います。URLパスとローカルディレクトリを結びつけるだけで、そのディレクトリの中身がまるごと配信されます。
基本の使い方
httplib::Server svr;
svr.set_mount_point("/", "./public");
svr.listen("0.0.0.0", 8080);
./public/index.htmlにはhttp://localhost:8080/index.htmlで、./public/css/style.cssにはhttp://localhost:8080/css/style.cssでアクセスできます。ディレクトリ構造がそのままURLに反映されます。
複数のマウントポイント
マウントポイントは複数登録できます。
svr.set_mount_point("/", "./public");
svr.set_mount_point("/assets", "./dist/assets");
svr.set_mount_point("/uploads", "./var/uploads");
同じパスに複数のマウントを登録することもできます。その場合は登録した順に探し、最初に見つかったファイルを返します。
APIハンドラと組み合わせる
静的ファイルとAPIハンドラは共存できます。GETとHEADのリクエストでは、まずマウントポイントからファイルを探し、見つからなければGet()などで登録したハンドラを呼びます。
svr.Get("/api/users", [](const auto &req, auto &res) {
res.set_content("[]", "application/json");
});
svr.set_mount_point("/", "./public");
これでSPAのように、/api/*はハンドラで、それ以外は./public/から配信、という構成が作れます。
MIMEタイプを追加する
拡張子からContent-Typeを決める対応表は組み込まれていますが、独自の拡張子を追加することもできます。
svr.set_file_extension_and_mimetype_mapping("wasm", "application/wasm");
Warning: 静的ファイル配信系のメソッドはスレッドセーフではありません。起動後（
listen()以降）には呼ばないでください。起動前にまとめて設定しましょう。
ダウンロード用のレスポンスを返したい場合はS06. ファイルダウンロードレスポンスを返すも参考になります。