libevhtp介绍与demo构建

心已赠人 2022-05-25 03:23 308阅读 0赞

本文主要介绍libevhtp的相关知识，以及libevhtp的demo构建，即搭建一个简单的HTTP SERVER（非加密）。

## 1. libevhtp介绍 ##

libevhtp 是 libevent's httpd API 的一个快速、灵活的替代品。通过使用 libevhtp，我们可以很容易地创建速度极快、安全的HTTP服务器。

## 2. demo构建 ##

本文介绍的是针对C++语言进行的libevhtp demo构建，相关软件信息如下：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;"> 软件名称 </td> 
 <td style="vertical-align:top;"> 软件版本 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> 操作系统 </td> 
 <td style="vertical-align:top;"> CentOS Linux release 7.4.1708 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> libevhtp </td> 
 <td style="vertical-align:top;"> 1.2.15 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> libevent </td> 
 <td style="vertical-align:top;"> 2.0.21 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> g++ </td> 
 <td style="vertical-align:top;"> 4.8.5 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> openssl </td> 
 <td style="vertical-align:top;"> 1.0.2k-8 </td> 
 </tr> 
 </tbody> 
</table>

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路径，观察网页信息，如下：

![70][]

如果网页中出现上述信息，说明libevhtp的demo部署成功了。

6.2 使用curl测试

在客户端上打开一个终端，执行下面的命令，测试libevhtp的http server部署情况，如下：

curl http://192.168.213.133:8080

上述curl命令执行结果如下：

![70 1][]

如果终端中出现上述信息，说明libevhtp的demo部署成功了。

**分析：**从上面的网页/终端信息能够看出，libevhtp调用了回调函数testcb，将字符串“foobar”通过结构体evhtp\_request\_t的buffer\_out成员返回给了web浏览器/curl，最终显示在网页/终端上了。