Nginx原始碼目錄結構

.
├── auto            自動檢測系統環境以及編譯相關的指令碼
│   ├── cc          關於編譯器相關的編譯選項的檢測指令碼
│   ├── lib         nginx編譯所需要的一些庫的檢測指令碼
│   ├── os          與平臺相關的一些系統引數與系統呼叫相關的檢測
│   └── types       與資料型別相關的一些輔助指令碼
├── conf            存放預設配置檔案，在make install後，會拷貝到安裝目錄中去
├── contrib         存放一些實用工具，如geo配置生成工具（geo2nginx.pl）
├── html            存放預設的網頁檔案，在make install後，會拷貝到安裝目錄中去
├── man             nginx的man手冊
└── src             存放nginx的原始碼
    ├── core        nginx的核心原始碼，包括常用資料結構的定義，以及nginx初始化執行的核心程式碼如main函式
    ├── event       對系統事件處理機制的封裝，以及定時器的實現相關程式碼
    │   └── modules 不同事件處理方式的模組化，如select、poll、epoll、kqueue等
    ├── http
 
        nginx作為http伺服器相關的程式碼
    │   └── modules 包含http的各種功能模組
    ├── mail        nginx作為郵件代理伺服器相關的程式碼
    ├── misc        一些輔助程式碼，測試c++頭的相容性，以及對google_perftools的支援
    |—— stream      nginx支援傳輸層的 協議：如TCP、UDP協議，UNINX域socket。這個模組是在nginx1.9以後版本才有的。
    └── os          主要是對各種不同體系統結構所提供的系統函式的封裝，對外提供統一的系統呼叫介面。
 

Nginx模組的型別

關於這個分類，大家各說風雲：

• 1.event module:搭建 獨立於作業系統的事件處理機制的框架，以及 提供各種具體事件的處理。包括ngx_events_module,ngx_event_core_module,ngx_epoll_module等。nginx 具體 使用何種事件處理 模組，這 很大依賴具體的作業系統和編譯選項。
• 2.phase handler:此型別模組也被直接稱為handler模組，主要負責處理客戶端請求併產生待響應的內容，比如ngx_http_static_moduler模組，負責客戶端的靜態頁面請求處理並將對應的磁碟 檔案準備為響應內容輸出。
• 3.output filter:也稱為filter模組，主要 負責處理輸出的內容，包括修改輸出內容，可以實現對輸出的所有的 html的 頁面新增 預定義的footbar一類的工作，或者對輸出的 圖片的URL進行替換的 工作。
• 4.upstream:upstream模組實現反向代理，將真正的請求 轉發到伺服器上，並 從後端伺服器上讀取響應，發回客戶端。upstream模組 是一種特殊的handler,只不過響應內容也不是真正由自己產生的，而是從後端伺服器上讀取的。
• 5.load-balancer:負載均衡模組，實現特定的 演算法，在 眾多的後端 伺服器中，選擇一個伺服器出來作為某個請求的轉發伺服器。

配置模組的設計

配置模組是所有 模組的基礎，它實現了最基本的配置項 的解析功能（也就是解析 nginx.conf）
核心模組的型別是ngx_core_module

核心 模組的定義

typedef struct {
    ngx_str_t             name;  //核心模組名稱
    void               *(*create_conf)(ngx_cycle_t *cycle);  //解析配置項前，Nginx框架會呼叫create_conf方法
    char               *(*init_conf)(ngx_cycle_t *cycle, void *conf); //解析配置項後，Nginx框架會呼叫init_conf方法
} ngx_core_module_t;

Nginx模組的載入

• 1.Nginx模組 是 被編譯進入Nginx，並不像Apache那樣去編譯一個so檔案，在配置裡面指定是否載入。
• 2.解析配置檔案時，Nginx的各個模組都有機會去接手處理某個請求，但是URL請求的模組只能有一個 。
• 3.Nginx啟動時框架的處理流程
  
  建議對比這篇部落格一起看Ngnix 的程式碼分析

Nginx模組的主要輪廓