libevhtp介绍

本文主要介绍libevhtp的相关知识，同时通过搭建一个简单的HTTP SERVER（非加密）介绍libevhtp的使用方法。

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

demo构建的步骤如下。

1. 安装libevent

本文使用yum进行libevent的安装，命令如下：

yum install libevent.x86_64 libevent-devel.x86_64

2. 安装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，最终显示在网页/终端上了。