Nginx源碼學習(2) ---- 模塊化及配置

    nginx的大部分功能都采用模塊化的方式加載到主程序，通過配置文件實現模塊的各種加載和參數配置。模塊化架構分析是nginx最關鍵的部分之一，本文作為參考文獻[1]的補充，深入分析nginx如何把配置文件和模塊管理聯系到一起的。
    可以說整個nginx都是由模塊來組成。nginx的模塊可以分為四種：core、 event、http和mail, core是核心模塊，event是事件處理模塊，本文重點以這兩個模塊為例進行分析。在編譯配置的時候，由自動腳本生成的objs/ngx_modules.c，定義了要包含的哪些模塊，保存到全局變量ngx_modules[] 中，
   
  而ngx_core_module, ngx_events_module這些全局變量，則在模塊的實現文件中定義。ngx_module_t的結構的主要成員見下圖。
 

commands是ngx_command_t的數組，表示該模塊支持的配置命令。
ctx是模塊上下文，保存著該模塊的關鍵的信息，比如event模塊上下文為ngx_event_module_t結構，該結構有一個ngx_event_actions_t成員，保存著事件處理函數，它把事件處理抽象成幾個函數（添加/刪除事件，查詢事件，事件響應），具體的epoll, select, kqueue等API根據配置來填入，下文將詳細講述。 模塊上下文一般都有create_conf和init_conf兩個鉤子，由于每個模塊都有一個屬于自己的配置結構體，用來保存該模塊的配置參數，這兩個函數鉤子就是創建和初始化該模塊的配置結構體。

nginx的進程啟動過程可參考文獻[1]，下面就一步步分析從配置文件到模塊載入和配置的整個過程。

nginx的配置文件示例如下圖


可以看到，nginx配置文件格式是：
   配置節名(也是命令的一種) {
       下一級配置節名{
           。。。 。。。
       }
       命令  值
   }

這里的命令就是上文的ngx_command_t結構中的name字符串，最外層的是對應ngx_core_module中的命令。整個配置過程如下：

main()
{
   ....
    // 所有模塊點一下數, 初始化index
    ngx_max_module = 0;
    for (i = 0; ngx_modules[i]; i++) {
        ngx_modules[i]->index = ngx_max_module++;
    }
   ngx_init_cycle(); //初始化并設置全局變量
   ///..........
   ngx_master_process_cycle(); //啟動進程，執行主循環干活， 參見文檔[2]
   ///..........
}

//設置全局變量
ngx_init_cycle()
{
    for (i = 0; ngx_modules[i]; i++) {
        if (ngx_modules[i]->type != NGX_CORE_MODULE) {
            continue;
        }
        module = ngx_modules[i]->ctx;    //取得模塊上下文, 例如ngx_core_module中的ngx_core_module_ctx

        // 調度core類型模塊的鉤子create_conf，并且把創建的配置結構體變量存放到cycle->conf_ctx中
        if (module->create_conf) {
            rv = module->create_conf(cycle);
            if (rv == NULL) {
                ngx_destroy_pool(pool);
                return NULL;
            }
            cycle->conf_ctx[ngx_modules[i]->index] = rv;   //這里是配置信息的結構體
        }
    }
    /* 例如ngx_core_module模塊，create_conf鉤子是調用ngx_core_module_create_conf, 該函數創建一個ngx_core_conf_t結構體，保存了全局的配置信息，比如子進程數，連接數，文件路徑等頂層信息，并返回。之后保存在全局cycle的conf_ctx對應位置(對應于模塊index)。 */
    //....
    ngx_conf_parse(&conf, &cycle->conf_file);   //分析配置文件


    // 調度core模塊的鉤子init_conf，設置剛才創建的配置結構體變量（用從配置文件中讀取的數據賦值）
    init_conf根據之前的conf_parse結果，填充配置結構體數值


    // 調度所有模塊的init_module鉤子，初始化模塊
    for (i = 0; ngx_modules[i]; i++) {
        if (ngx_modules[i]->init_module) {   //調用模塊的初始化函數
            if (ngx_modules[i]->init_module(cycle) != NGX_OK) {

                exit(1);
            }
        }
    }
   .....
}

ngx_conf_parse()
{
   //循環對配置文件進行語法分析
   ngx_conf_read_token(); //讀取下一個token
   //根據{ }來設置ngx_conf_s中的變量，改變當前的模塊配置節
   ngx_conf_handler();   //分析該配置節下的模塊命令.
}

ngx_conf_handler()
{
   //1. 遍歷模塊的command_s數組，strcmp來比對命令
   //2. 根據command_t的參數指定，讀取后續參數
   //3. 獲取該模塊的配置結構體，以及該命令相關的參數在配置結構體中的偏移量(根據command_t中的offset)
   //4. 調用command_t中的set鉤子，把讀到參數值賦值給配置結構體
}

最后在模塊的init_conf函數中可以根據配置值，來做相應的操作。
比如底層的事件處理庫，use指令指示用select還是epoll呢，比如use epoll
那么這些event模塊在init的時候，就會判斷配置結構體中的use, 如果是自己，則把event_actions賦值給全局變量ngx_event_actions，
這樣，其他模塊就可以通過ngx_event_actions中的鉤子進行事件處理操作, 隔離了底層實現。

參考文獻
[1] nginx源碼分析--模塊化(1) http://blog.sina.com.cn/s/blog_677be95b0100iive.html
[2] nginx的進程模型。http://simohayha.javaeye.com/blog/467940

posted on 2010-06-18 16:15 Daly 閱讀(2519) 評論(0)  編輯 收藏 引用 所屬分類: C/C++ 、網絡編程