C语言-apache mod(模块开发)-采用VS2017开发实战(windows篇)

C语言-apache mod(模块开发)-采用VS2017开发实战(windows篇)



名词解释：apxs

apxs is a tool for building and installing extension modules for the Apache HyperText Transfer Protocol (HTTP) server.

apxs是用来编译和安装 apache 服务器的扩展模块(mod)、也能生成项目模版(下面有具体使用说明)

名词解释：MinGW

MinGW，是Minimalist GNUfor Windows的缩写。它是一个可自由使用和自由发布的Windows特定头文件和使用GNU工具集导入库的集合，

允许你在GNU/Linux和Windows平台生成本地的Windows程序而不需要第三方C运行时（C Runtime）库。

MinGW 是一组包含文件和端口库，其功能是允许控制台模式的程序使用微软的标准C运行时（C Runtime）库（MSVCRT.DLL）,该库在所有的 NT OS 上有效，

在所有的 Windows 95发行版以上的 Windows OS 有效，使用基本运行时，你可以使用 GCC 写控制台模式的符合美国标准化组织（ANSI）程序，

可以使用微软提供的 C 运行时（C Runtime）扩展，与基本运行时相结合，就可以有充分的权利既使用 CRT（C Runtime）又使用 WindowsAPI功能。



一、apache mod模块 windows开发

1）

下载apxs apxs_win32.tar.gz，下载地址

http://download.csdn.net/detail/tengyunjiawu_com/9811400



2）

安装strawberryperl或active perl

下载地址：http://strawberryperl.com/releases.html

我安装的是active perl,所以还需要安装 dmake

dos命令行执行：ppm install dmake



3）解压apxs_win32.tar.gz 

   解压到C:\apache\apache2.4.9\bin\apxs



4)进入C:\apache\apache2.4.9\bin\apxs目录

perl Configure.pl --with-apache2=D:/wamp/bin/apache/apache2.4.9 --with-apache-prog=httpd.exe



5）切换到Apache安装目录下的bin文件夹中，输入apxs，

cd C:\apache\apache2.4.9\bin

apxs

输出：如有解释apxs用法的文本出现（如下），则表明安装完成。

D:\wamp\bin\apache\apache2.4.9\bin>apxs

Usage: apxs -g [-S <var>=<val>] -n <modname>

      apxs -q [-v] [-S <var>=<val>] <query> ...

      apxs -c [-S <var>=<val>] [-o <dsofile>] [-D <name>[=<value>]]

      [-I <incdir>] [-L <libdir>] [-l <libname>] [-Wc,<flags>]

      [-Wl,<flags>] [-p] <files> ...

      apxs -i [-S <var>=<val>] [-a] [-A] [-n <modname>] <dsofile> ...

      apxs -e [-S <var>=<val>] [-a] [-A] [-n <modname>] <dsofile> ...



6）将apxs所在的目录设置加入系统环境变量PATH



7）使用apxs

apxs编译时还需用到C/C++编译器，一般有两种选择，一种是使用VC(Visual Studio)自带的编译器，还有一种就是自行安装，比如minGW等。

对使用VS编译的，可尝试修改apache下的build目录中config_vars.mk配置文件：

CC = gcc 的gcc改为cl.exe

LD = g++的g++改为link.exe

CPP = gcc-E的gcc-E删掉

我因为使用的是mingw，所以，实际应用步骤可能不太完整，所以使用VS2017编译的时候没有使用apxs进行编译

vs2017编译如下：

8）用VS2017编译apache模块

   a)运行apxs -g -n helloworld(helloworld为模块名),会生成一个叫helloworld的目录和模板代码

   b)打开vs2017建立一个空的C语言项目，项目名称mod_helloworld，将上面用apxs生成的mod_helloworld.c拖进项目

   c)项目设置部分

1、include C:\apache\apache2.4.9\include 

2、lib部分附加目录库 C:\apache\apache2.4.9\lib 

3、链接器，命令行，其他选项添加 libapr-1.lib libaprutil-1.lib libapriconv-1.lib libhttpd.lib

        4、代码生成 运行库选择：多线程 (/MT)

   d)进入helloworld目录，编辑mod_helloworld.c(这就是我们要开发的内容)，代码如下：

=========================================================================================

/* 

**  mod_helloworld.c -- Apache sample helloworld module

**  [Autogenerated via ``apxs -n helloworld -g'']

**

**  To play with this sample module first compile it into a

**  DSO file and install it into Apache's modules directory 

**  by running:

**

**    $ apxs -c -i mod_helloworld.c

**

**  Then activate it in Apache's httpd.conf file for instance

**  for the URL /helloworld in as follows:

**

**    #   httpd.conf

**    LoadModule helloworld_module modules/mod_helloworld.so

**    <Location /helloworld>

**    SetHandler helloworld

**    </Location>

**

**  Then after restarting Apache via

**

**    $ apachectl restart

**

**  you immediately can request the URL /helloworld and watch for the

**  output of this module. This can be achieved for instance via:

**

**    $ lynx -mime_header http://localhost/helloworld 

**

**  The output should be similar to the following one:

**

**    HTTP/1.1 200 OK

**    Date: Tue, 31 Mar 1998 14:42:22 GMT

**    Server: Apache/1.3.4 (Unix)

**    Connection: close

**    Content-Type: text/html

**  

**    The sample page from mod_helloworld.c

*/ 





#include "httpd.h"

#include "http_config.h"

#include "http_protocol.h"

#include "ap_config.h"





/* The sample content handler */

static int helloworld_handler(request_rec *r)

{

    if (strcmp(r->handler, "helloworld")) {

        return DECLINED;

    }

    r->content_type = "text/html";      





    if (!r->header_only)

        ap_rputs("小样，用C语言开发一个Apache的Module，这下牛逼了吧\n", r);

    return OK;

}





static void helloworld_hooks(apr_pool_t *p)

{

    ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE);

}





/* Dispatch list for API hooks */

module AP_MODULE_DECLARE_DATA helloworld_module = {

    STANDARD20_MODULE_STUFF, 

    NULL,                  /* create per-dir    config structures */

    NULL,                  /* merge  per-dir    config structures */

    NULL,                  /* create per-server config structures */

    NULL,                  /* merge  per-server config structures */

    NULL,                  /* table of config file commands       */

    helloworld_hooks  /* register hooks                      */

};

=========================================================================================

   e)编译生成如下图：

f)将mod_helloworld.dll拷贝到Apache2.2\modules下

   g)修改Apache2.2\conf\httpd.conf，在末尾加上

     LoadModule helloworld_module modules/mod_helloworld.dll #(dll改成扩展名.so也一样的)

     <Location /helloworld>

setHandler helloworld

     </Location>

    

   h)启动apache，在浏览器里面输入http://loacalhost/helloworld，就可以看到我们返回的内容)

     大功告成





9）VS2017整体工程代码，下载地址：

http://download.csdn.net/detail/tengyunjiawu_com/9811386

10）运行结果如下：http://loacalhost/helloworld

本人原创，未经许可，可以随意转载！