Web服务器 Mongoose 的介绍与安装

本文主要内容如下:

  • 1、Mongoose介绍
  • 2、Mongoose的编译和使用
  • 3、Makefile的简单分析
  • 4、如何将Mongoose嵌入到应用程序中
1、Mongoose介绍

Mongoose开源项目的主页是http://code.google.com/p/mongoose/。Mongoose是一个web服务器,通过提供一个web接口给它,它可以嵌入到现有的应用程序中去。Mongoose web服务器的执行是自满足的,它不依赖于任何其他服务。如果你将它复制到任何目录并执行,它将将启动web服务并将当前目录作为主目录、端口号是8080。当然这些配置选项都可以通过配置文件mongoose.conf设置。

Mongoose它的前身是shttpd,它完全开源和自由使用。它还具有如下特性:

  • 跨平台——Windows、MacOS 、 大多数UNIX
  • CGI, SSL, SSI, Digest (MD5) authorization, resumed download, aliases
  • IP-based ACL, Windows service, GET, POST, HEAD, PUT, DELETE methods
  • Small footprint: executable size is 40 kB on Linux 2.6 i386 system, 60 kB on Windows system
  • 能够用简单和干净的API嵌入到应用程序中
  • Language suport for:
    • C/C++ (native)
    • Python - since version 2.6 (done)
    • C# - since version 2.7 (done)
    • Ruby - since version 2.9 (todo)
    • Lua - since version 2.9 (todo)
2、Mongoose的编译和使用

关于Mongoose上面应该已经介绍了它的主要特性。所谓耳听为虚,眼见为实,不过现在这个时代眼见也未必为实,正所谓实践见真知,下面还是来亲身体验下。Windows版本的Mongoose安装和使用,我就不介绍了,众所周知Windows下面的软件的安装基本都是傻瓜式的。下面我介绍的是linux下mongoose的编译和使用(我使用的linux是Ubuntu 10.04)。

首先去主页上面下载Mongoose的源码(mongoose-2.8.tgz)。将其解压可以看到如下的文件列表:

Web服务器 Mongoose

图1、mongoose源码的文件列表

其实我们主要用到的就是mongoose.h/c文件,像main.c文件只是用来测试用的。如果你想将mongoose嵌入到你的项目中,主需要用到mongoose.h/c就ok了!而且以后主要的剖析工作就是放在mongoose.h/c上。其中的Makefile文件是用于编译,生成可执行文件和库文件等。

用make linux命令就可以将源码编译为linux版本的mongoose,如下图所示:

Web服务器 Mongoose

图2、linux下面Mongoose的编译和执行

如上图,当我们输入make命令的时候,会提示你带相应环境的参数make (linux|bsd|solaris|mac|windows|mingw),这里我们选择linux。编译完之后,生成了两个文件:一个可执行文件mongoose、一个库文件_mongoose.so。你可以直接将_mongoose.so库文件拿到你的项目中去使用(当然是基于linux环境的项目,如果在Windows环境下是编译出相应的dll文件,去直接使用)。

从上图可以看出,编译完之后我们运行了(./mongoose),看到Mongoose 2.8 started on port(s) [8080], serving directory [/home/netsky/Downloads/mongoose]。即现在就启动了web server,当前工作目录是/home/netsky/Downsloads/mongoose,端口号是8080。我们可以在浏览器中输入http://localhost:8080/来访问web服务器(或者如果你跟我一样是在Ubuntu是运行在虚拟机中,你可以在外面的Windows系统中用浏览通过http://linux的ip:8080/来访问),如下图所示:

Web服务器 Mongoose

图3、访问mongoose开启的web服务

我们查看mongoose打出来的log,如下图:

Web服务器 Mongoose

图4、mongoose打印的log

从log可以看出有两个client,一个是我刚才在linux里面通过浏览器打开web服务的根目录;另一个是我在Windows下面通过浏览器打开web服务的根目录。

3、Makefile的简单分析

下面我们简单分析一下Makefile文件,看我们执行make linux的时候,编译了什么源文件,及编译的一些选项。

从PROG= mongoose和LIB= _$(PROG).so可以知道编译生成的执行文件名和库的名字;

从linux:
$(CC) $(LINFLAGS) mongoose.c -shared -fPIC -fpic -s -o $(LIB)
$(CC) $(LINFLAGS) mongoose.c main.c -s -o $(PROG)
我们知道,在linux下面编译用到了哪些源文件:编译库文件_mongoose.so时仅用到了mongoose.c文件,编译可执行文件时除了mongoose.c文件还用到了main.c。注意上面的变量$(LINFLAGS),即编译时的选项为:
Web服务器 Mongoose

其中$(COPT)选项是我们make的时候跟的一些选项,下面列出这些选项及其意义:

all:
        @echo "make (linux|bsd|solaris|mac|windows|mingw)"

# Possible COPT values: (in brackets are rough numbers for 'gcc -O2' on i386)
# -DHAVE_MD5            - use system md5 library (-2kb)
# -DNDEBUG              - strip off all debug code (-5kb)
# -DDEBUG               - build debug version (very noisy) (+7kb)
# -DNO_CGI              - disable CGI support (-5kb)
# -DNO_SSL              - disable SSL functionality (-2kb)
# -DCONFIG_FILE=\"file\" - use `file' as the default config file
# -DNO_SSI              - disable SSI support (-4kb)
# -DHAVE_STRTOUI64      - use system strtoui64() function for strtoull()

Makefile就简单的分析到这了,现在应该比较清楚可执行文件及库是怎么生成的了。(提示:Windows下面的编译,Makefile文件中也已经给出了,请查看Makefile文的后半部分。)

4、如何将Mongoose嵌入到应用程序中

目前Mongoose可以支持嵌入到C/C++、Python、C#,而且在下一个版本(2.9)将支持Ruby、Lua。但在这里我只介绍怎么样将Mongoose嵌入到C/C++中。其实将Mongoose嵌入到C/C++应用程序中很简单,因为Mongoose本来就是用C编写的,因此可以非常简单的将它嵌入到你的应用程序中。

  • 首先,拷贝mongoose.h/c到你的源码目录下
  • 然后,在你的应用程序中启动和配置mongoose。其实自带的main.c就是一个很好的例子,当我们编mongoose的可执行文件时就用到了它。你完全可以把main.c当做你的应用程序,完全一样,当然业务逻辑不同。(后面假设你的应用程序名为main.c,当然怎么命名随你喜欢!)
  • 最后,跟上面我们分析的Makefile中介绍到的如何在linux下编译Mongoose一样,你也是用下面的命令编译:
    cc main.c mongoose.c –ldl -lpthread –o test
    关于编译选项-pthread:Mongoose中在程序中用到了pthread.h头文件中的函数时需要加这个选项。在编译的时候加上此选项会去链接libpthread.a或libpthread.so文件。

关于如何编写类似main.c代码调用mongoose提供的接口,这个工作在本系列后面的文章中介绍。

至此,将Mongoose嵌入到你的C/C++应用程序中的工作已经完成,现在你执行./test即可以应用你的应用程序,它调用到了mongoose提供的一些接口。

通常上面的介绍,是不是觉得在应用程序嵌入Mongoose很简单呢!是的就是这么简单。

 

作者:吴秦
出处:http://www.cnblogs.com/skynet/

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
简介:

mongoose是一款small,fast,easy to use 的web服务器。使用CGISSLMD5授权。

mongoose不与终端进行分离(1),使用当前的工作目录作为web服务器的root目录,除非使用 -r 选项。它能够同时监听多个端口。如为了能监听HTTP 协议端口 80和HTTPS协议端口 443,在启动mongoose时须输入:mongoose -s cert.pem -p 80,443s

与其他web服务器不同,mongoos不一定要把CGI脚本放在一个特别的目录下,可以放在任何地方。CGI(and SSI)文件能被mongoose根据它们的文件扩展名而识别。

如果启动时没有给定参数,mongoose将在与mongoos 执行文件(bin)同一个目录下面搜索名为“mongoose.conf”的配置文件进行配置。另一种选择是,在启动参数中包含有你指定的文件名。 

使用示范: mongoose -r /var/www,/aa=/tmp,/bb=/etc -s /etc/cert.pem -p 8080,8043s Start listening on port 8080 for HTTP, and 8043 for HTTPS connec- tions. Use /etc/cert.pem as SSL certificate file. Web root is /var/www. In addition, map directory /tmp to URI /aa, directory /etc to URI /bb.

mongoose -l -0.0.0.0/0,+10.0.0.0/8,+1.2.3.4 Deny connections from everywhere, allow only IP address 1.2.3.4 and all IP addresses from 10.0.0.0/8 subnet to connect.

COPYRIGHT mongoose is licensed under the terms of the MIT license.

AUTHOR Sergey Lyubka <valenok@gmail.com>.

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值