萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 配置文件解析流程源碼級分析 (ngx_init_cycle、ngx_conf_parse)

深度剖析 Nginx 啟動階段配置文件解析核心流程:ngx_init_cycle → ngx_conf_parse → 模塊配置創建、合併、階段初始化。

ngx_init_cycle 關鍵步驟

  1. 分配 ngx_cycle_t,初始化成員。
  2. 調用 core 模塊 create_conf → 生成 ngx_core_conf_t 存入 cycle->conf_ctx。
  3. 初始化 ngx_conf_t 解析上下文。
  4. ngx_conf_parse 遞歸解析配置文件,結果存入各模塊 conf 結構。
  5. 調用 core 模塊 init_conf:對未設值 (=-1) 賦予默認值。
  6. ngx_open_listening_sockets:遍歷 listening 數組,socket→setsockopt→bind→listen。
  7. 調用所有模塊 init_module (僅 ngx_event_module_init 實現)。

ngx_conf_parse 解析循環

循環讀取指令 → 匹配命令表 → 調用對應 set 處理函數 → 寫入模塊配置結構體偏移位置。

三大模塊類型配置創建

Core 模塊

指令如 daemon,set 為 ngx_conf_set_flag_slot,直接操作 ngx_core_conf_t 成員。

Event 模塊

  • 指令 events { },set 為 ngx_events_block。
  • 創建 ngx_event_conf_t 及各事件模塊 (epoll/kqueue) 配置結構。
  • 遞歸解析 events 塊內指令。

HTTP 模塊 (最複雜)

  • 指令 http { },set 為 ngx_http_block。
  • 創建 ngx_http_conf_ctx_t,含 main_conf、srv_conf、loc_conf 三層數組。
  • 遍歷 HTTP 模塊調用 create_main_conf/srv_conf/loc_conf 填充三層數組。
  • 調用 preconfiguration 鉤子。
  • 遞歸解析 http 塊:
     • main 指令寫入 main_conf (如 variables_hash_max_size)
     • server 指令:複製 main_conf、新建 srv_conf/loc_conf 進入 server 上下文
     • location 指令:繼承 main/srv、新建 loc_conf 進入 location 上下文
  • 返回 ngx_http_block:調用 init_main_conf、ngx_http_merge_servers 合併 server/location 配置。

ngx_command_s 結構體


struct ngx_command_s {
    ngx_str_t name;           // 指令名
    ngx_uint_t type;          // 參數類型、作用域標誌
    char *(*set)(ngx_conf_t*, ngx_command_t*, void*); // 處理函數
    ngx_uint_t conf;          // 配置結構相對偏移 (NGX_HTTP_MAIN_CONF_OFFSET 等)
    ngx_uint_t offset;        // 成員在結構體內偏移
    void *post;               // 後處理回調
};

conf + offset 精確定位目標成員地址,實現通用配置寫入。

copyright © 萬盛學電腦網 all rights reserved