mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-08-21 09:35:02 +00:00
0fa4912891
Cookbook body links referenced sibling pages with a bare slug (e.g. `c14-keep-alive`). Under the pretty-URL layout each page lives in its own directory, so these resolve against the page's own directory and 404. Prefix them with `../` to match the convention already used in the tour and llm-app sections. Verified clean with `docs-gen check`.
2.4 KiB
2.4 KiB
title, order, status
| title | order | status |
|---|---|---|
| C07. ファイルをマルチパートフォームとしてアップロードする | 7 | draft |
HTMLフォームの<input type="file">と同じ形式でファイルを送りたいときは、マルチパートフォーム（multipart/form-data）を使います。cpp-httplibはUploadFormDataItemsとFormDataProviderItemsの2種類のAPIを用意しています。使い分けの基準はファイルサイズです。
小さなファイルを送る
ファイル内容をメモリに読み込んでから送る方法です。サイズが小さいなら、これが一番シンプルです。
httplib::Client cli("http://localhost:8080");
std::ifstream ifs("avatar.png", std::ios::binary);
std::string content((std::istreambuf_iterator<char>(ifs)),
std::istreambuf_iterator<char>());
httplib::UploadFormDataItems items = {
{"name", "Alice", "", ""},
{"avatar", content, "avatar.png", "image/png"},
};
auto res = cli.Post("/upload", items);
UploadFormDataの各要素は{name, content, filename, content_type}の4つです。テキストフィールドならfilenameとcontent_typeを空文字にしておきます。
大きなファイルをストリーミングで送る
ファイル全体をメモリに載せずに、チャンクごとに送りたいときはmake_file_provider()を使います。内部でファイルを少しずつ読みながら送信するので、巨大なファイルでもメモリを圧迫しません。
httplib::Client cli("http://localhost:8080");
httplib::UploadFormDataItems items = {
{"name", "Alice", "", ""},
};
httplib::FormDataProviderItems provider_items = {
httplib::make_file_provider("video", "large-video.mp4", "", "video/mp4"),
};
auto res = cli.Post("/upload", httplib::Headers{}, items, provider_items);
make_file_provider()の引数は(フォーム名, ファイルパス, ファイル名, Content-Type)です。ファイル名を空にするとファイルパスがそのまま使われます。
Note:
UploadFormDataItemsとFormDataProviderItemsは同じリクエスト内で併用できます。テキストフィールドはUploadFormDataItems、ファイルはFormDataProviderItems、という使い分けがきれいです。
アップロードの進捗を表示したい場合はC11. 進捗コールバックを使うを参照してください。