Libmicrohttpd簡介
GNU Libmicrohttpd是一個用來在項目中內嵌http服務器的C語言庫,它具有以下幾個非常鮮明的特點:
- C語言庫,小而快。
- API非常簡單,且都是可重入的。
- 兼容HTTP1.1。
- 支持4種多線程模型(select、poll、pthread、thread poll)。
- 跨平台。
- 生成的二制文件只有32K(不包含TLS/SSL等額外功能)。
搭建一個簡單的本地靜態服務器
這篇文章里,我們只編寫一個簡單的靜態服務器,對於用戶的所有請求我們都只返回同一個html頁面, 該頁面顯示一串字符。
1. 下載Libmicrohttpd,編譯后添加進VS項目
為了使用Libmicrohttpd,我們需要將其添加進VS項目中。這里我們選擇編譯源代碼生成靜態庫,因為官方給的下載靜態庫版本鏈接在使用時會有問題,可能是運行庫版本不一致; 並且在使用靜態庫的情況下,我們只需要引用兩個文件就可以了(一個頭文件、一個庫文件),項目結構不會混亂不清。
實際上Libmicrohttpd的源碼編譯非常簡單,它提供了VS編譯文件,基本上我們只需要進入w32
目錄,在該目錄下選擇合適的VS子目錄下的sln文件,雙擊打開就可以了。打開后,修改設置libmicrohttpd項目為靜態庫項目(記得修改生成文件的后綴名,因為默認是dll),右擊生成就可以編譯成功了。
生成的文件包括一個頭文件和一個靜態庫文件,新建一個VS控制台項目,並將它們添加到VS項目中。
2. main函數
main函數非常簡單,核心調用只有2個函數:MHD_start_daemon
,MHD_stop_daemon
,分別開始和停止http服務器。
int main()
{
const int port = 8888;
struct MHD_Daemon* daemon =
MHD_start_daemon(MHD_USE_SELECT_INTERNALLY, port
, NULL, NULL, connectionHandler, NULL, MHD_OPTION_END);
if (daemon == NULL) {
std::cout << "cannot start server!\n";
return -1;
}
std::cin.get();
MHD_stop_daemon(daemon);
return 0;
}
MHD_start_daemon函數包含非常多的參數,這也意味着它集成了很多的功能,這里我們只關注四個參數,其它都為NULL:
- MHD_USE_INTERNAL_POLLING_THREAD。這個參數與其他兩個參數(MHD_USE_POLL_INTERNAL_THREAD、MHD_USE_EPOLL_INTERNAL_THREAD)一起構成了microhttpd支持的三種模式:select、poll、epoll。用戶必須選擇這三種模式之一。具體信息見源碼。
- port。端口號。
- connectHandler。處理請求的函數。
- MHD_OPTION_END。由於MHD_start_daemon最后一個參數是一個變參,因此MHD_OPTION_END用來表示變參終止。
MHD_stop_daemon函數比較簡單,這里不介紹了。
3 請求處理函數
所有的請求處理都發生在connectionHandler
中:
int connectionHandler(
void *cls,
struct MHD_Connection *connection,
const char *url,
const char *method,
const char *version,
const char *upload_data,
size_t *upload_data_size,
void **con_cls)
{
const char* pageBuffer = "<html><body>Hello, I'm lgxZJ!</body></html>";
struct MHD_Response *response;
response = MHD_create_response_from_buffer(strlen(pageBuffer),
(void*)pageBuffer, MHD_RESPMEM_PERSISTENT);
if (MHD_add_response_header(response, "Content-Type", "text/html") == MHD_NO) {
std::cout << "MHD_add_response_header error\n";
return MHD_NO;
}
if (MHD_queue_response(connection, MHD_HTTP_OK, response) == MHD_NO) {
std::cout << "MHD_queue_response error\n";
return MHD_NO;
}
MHD_destroy_response(response);
return MHD_YES;
}
這個函數簽名包含了所有用來處理請求的有用信息,這里不逐一介紹了。microhttpd庫提供了函數來方便我們響應請求,這里我們重點看創建響應。microhttpd庫提供了兩種方法來創建請求:從buffer創建、從文件創建。但是后者需要傳入一個文件描述符,這在windows上不是很方便。
我們這里用緩沖創建。需要注意的是最后一個參數,這是一個MHD_ResponseMemoryMode
枚舉值,表示我們使用的buffer內容是固定不變的。這種枚舉類型還包含其他2種代表瞬時緩沖類型的值,分別表示緩沖區是在heap上的,和非heap(例如stack)上的。 用不同的緩沖區時要記得用不同的枚舉值。 接下來設置MIME類型,把緩沖入隊,並釋放MHD_Response結構體。對於正確響應,我們返回MHD_YES;不能響應的,我們返回MHD_NO。
運行程序,我們打開瀏覽器並輸入127.0.0.1:8888
,得到如下結果:
還能做更多
MHD_start_daemon
函數還可以限制特定ip的訪問。- 請求處理函數還包含請求方法和請求數據。
- 我們還可以掛起、恢復連接。
- ......