Apache Modules Book 阅读笔记 （一）

    先记载一下今天看到别人讨论用Apache模块开发时的一句话，比喻得很有意思：

    做一个能用的软件， 和做一个完善的系统差别很大。一个好的经济学的比喻： 你能做出比麦当劳更好吃的汉堡，但是你能不能做出比麦当劳更庞大的快餐行业。

    开始进入正题了。上周已经在开始看代码了，这周才发现用的是apache模块开发，真是很惭愧，发现读代码时还是方法不到位，意识不强烈。

    有一些好的学习网址先记录一下：

        http://www.chinaunix.net/jh/13/951219.html

    下载了《 The Apache Modules Book 》，准备快速翻翻，边加上查找些资料，做下学习笔记了。

    没看成，先转载一份初级入门的吧。。出处：http://andrew913.iteye.com/blog/398648

    Apache模块开发主要采用挂钩子的方法来实现模块开发的，这和linux内核模块开发有点像，说白了就是加一个回调函数。（记一下，对C++挂钩还不太明白是什么）

    下面给出了一个具体的例子。

    首先来介绍下apache的一个工具apxs。apxs是一个为Apache HTTP服务器编译和安装扩展模块的工具，用于编译一个或多个源程序或目标代码文件为动态共享对象，使之可以用由mod_so提供的LoadModule指令在运行时加载到Apache服务器中。

apxs -g -n helloworld 

上面的命令可以帮助我们产生一个模块名字为helloworld的模板，这个模板的代码如下：

    #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("The sample page from mod_helloworld.c\n", r);  
        return OK;  
    }  
      
    static void helloworld_register_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,                  /* 创建目录配置结构*/  
        NULL,                  /* 合并目录配置结构 */  
        NULL,                  /* 创建主机配置结构 */  
        NULL,                  /* 合并主机配置结构 */  
        NULL,                  /* 为模块配置相关指令       */  
        helloworld_register_hooks  /* 注册模块的钩子函数                      */  
    };  

    helloworld_module这个结构体中，每个参数的含义在代码中有注释说明，最重要的是最后一个参数，注册模块的钩子函数helloworld_register_hooks，也就是说当我们把模块加入到apache里面去的时候，他会执行这个注册函数。在这个函数里面我们将会注册我们所要添加的钩子。

    可以看到，在这个示例中注册钩子函数的语句为：

ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE); 

    这个处理函数注册了helloworld_handler这个函数。APR_HOOK_MIDDLE在当该函数调用次序无关紧要时，可以设置为该值。

    执行的顺序，模块加载；执行helloworld_register_hooks函数；注册helloworld_handler这个函数到钩子上去。
    而当一个http请求来的时候，helloworld_handler这个函数就会被自动执行。

    （未完待续）