本文主要介绍libevhtp的相关知识,以及libevhtp的demo构建,即搭建一个简单的HTTP SERVER(非加密)。
1. libevhtp介绍
libevhtp 是 libevent's httpd API 的一个快速、灵活的替代品。通过使用 libevhtp,我们可以很容易地创建速度极快、安全的HTTP服务器。
2. demo构建
本文介绍的是针对C++语言进行的libevhtp demo构建,相关软件信息如下:
软件名称 |
软件版本 |
操作系统 |
CentOS Linux release 7.4.1708 |
libevhtp |
1.2.15 |
libevent |
2.0.21 |
g++ |
4.8.5 |
openssl |
1.0.2k-8 |
1. 安装libevent
安装libevent软件,本文使用yum进行libevent的安装,如下:
yum install libevent.x86_64 libevent-devel.x86_64
2. 安装openssl
安装openssl软件,本文使用yum进行openssl的安装,如下:
yum install openssl openssl-devel
3. 下载及构建libevhtp
下载libevhtp源码:
wget "https://github.com/ellzey/libevhtp/archive/1.2.15.tar.gz" -O libevhtp-1.2.15.tar.gz
解压libevhtp源码:
tar xvf libevhtp-1.2.15.tar.gz
进入解压后的libevhtp的build目录中,构建libevhtp,如下:
[root@liitdar /opt/liitdar/libevhtp]# cd libevhtp-1.2.15/build/ [root@liitdar /opt/liitdar/libevhtp/libevhtp-1.2.15/build]# cmake .. [root@liitdar /opt/liitdar/libevhtp/libevhtp-1.2.15/build]# make
上述命令执行后,会在build目录中生成libevhtp的静态库:libevhtp.a ,这个静态库是我们使用libevhtp API编程所需要的。
4. 编写demo程序
编写使用 libevhtp API 的C++程序,代码(test.cpp)如下:
#include <iostream> #include "evhtp.h" using namespace std; void testcb(evhtp_request_t *req, void *a) { evbuffer_add_reference(req->buffer_out, "foobar\n", 7, NULL, NULL); evhtp_send_reply(req, EVHTP_RES_OK); } int main(int argc, const char *argv[]) { evbase_t *evbase = event_base_new(); evhtp_t *htp = evhtp_new(evbase, NULL); /* 设置回调函数 */ evhtp_set_cb(htp, "/", testcb, NULL); /* 监听本地所有IP的8080端口, backlog为1024 */ evhtp_bind_socket(htp, "0.0.0.0", 8080, 1024); /* 进入循环、监听连接,http server开始工作 */ event_base_loop(evbase, 0); return 0; }
5. 编译demo程序
运行下列命令,编译demo程序:
g++ -o test test.cpp -I/opt/liitdar/libevhtp/libevhtp-1.2.15/include/ -L/opt/liitdar/libevhtp/libevhtp-1.2.15/build/ -levhtp -levent -lpthread -levent_openssl -lssl -lcrypto
说明:
- 需要根据实际情况设置头文件路径,并在头文件路径中添加需要的头文件;
- 需要根据实际情况设置静态库 libevhtp.a 的地址;
- 因为libevhtp的静态库 libevhtp.a 中包含了一些ssl的内容,所以在我们使用该静态库时,也需要连接一下ssl的相关库。
6. 测试demo程序
打开一个终端,运行刚刚生成的demo程序,如下:
[root@liitdar /opt/liitdar/libevhtp/libevhtp-1.2.15/build]# ./test
因为本文中创建的 http server 监听的是8080端口,所以查询一下8080端口是否被test程序监听了,如下:
[root@liitdar ~]# netstat -apont |grep 8080 tcp 0 0 0.0.0.0:8080 0.0.0.0:* LISTEN 10911/./test off (0.00/0/0) [root@liitdar ~]#
从上面的查询结果能够看出,8080端口已经被test程序监听了。
6.1 使用web浏览器测试
在客户端上打开web浏览器,输入test监听的服务器的IP地址、端口及URL路径,观察网页信息,如下:
如果网页中出现上述信息,说明libevhtp的demo部署成功了。
6.2 使用curl测试
在客户端上打开一个终端,执行下面的命令,测试libevhtp的http server部署情况,如下:
curl http://192.168.213.133:8080
上述curl命令执行结果如下:
如果终端中出现上述信息,说明libevhtp的demo部署成功了。
分析:从上面的网页/终端信息能够看出,libevhtp调用了回调函数testcb,将字符串“foobar”通过结构体evhtp_request_t的buffer_out成员返回给了web浏览器/curl,最终显示在网页/终端上了。