Nginx處理請求的11個階段（agentzh的Nginx 教程學習記錄）

時間 2019-11-06

標籤 nginx 處理請求階段 agentzh 教程學習記錄欄目 Nginx 简体版

原文原文鏈接

Nginx 處理請求的過程一共劃分爲 11 個階段，按照執行順序依次是 post-read、server-rewrite、find-config、rewrite、post-rewrite、preaccess、access、post-access、try-files、content 以及 log。

一、post-read

最早執行的 post-read 階段在 Nginx 讀取並解析完請求頭（request headers）以後就當即開始運行。例如：使用了 ngx_realip 模塊提供的 set_real_ip_from 和 real_ip_header 這兩條配置指令

二、server-rewrite

因爲 server-rewrite 階段位於 post-read 階段以後，因此 server 配置塊中的 set 指令也就老是運行在 ngx_realip 模塊改寫請求的來源地址以後。

三、find-config

這個階段並不支持 Nginx 模塊註冊處理程序，而是由 Nginx 核心來完成當前請求與 location 配置塊之間的配對工做。換句話說，在此階段以前，請求並無與任何 location 配置塊相關聯。所以，對於運行在 find-config 階段以前的 post-read 和 server-rewrite 階段來講，只有 server 配置塊以及更外層做用域中的配置指令纔會起做用。這就是爲何只有寫在 server 配置塊中的 ngx_rewrite 模塊的指令纔會運行在 server-rewrite 階段，這也是爲何前面全部例子中的 ngx_realip 模塊的指令也都特地寫在了 server 配置塊中，以確保其註冊在 post-read 階段的處理程序可以生效。

四、rewrite

因爲 Nginx 已經在 find-config 階段完成了當前請求與 location 的配對，因此從 rewrite 階段開始，location 配置塊中的指令即可以產生做用。當 ngx_rewrite 模塊的指令用於 location 塊中時，即是運行在這個 rewrite 階段。

五、post-rewrite

這個階段也像 find-config 階段那樣不接受 Nginx 模塊註冊處理程序，而是由 Nginx 核心完成 rewrite 階段所要求的「內部跳轉」操做（若是 rewrite 階段有此要求的話）。例如：經過 rewrite 指令把當前請求的 URI 無條件地改寫爲 /bar，同時發起一個「內部跳轉」，最終跳進了 location /bar 中。這裏比較有趣的地方是「內部跳轉」的工做原理。「內部跳轉」本質上其實就是把當前的請求處理階段強行倒退到 find-config 階段，以便從新進行請求 URI 與 location 配置塊的配對。

六、preaccess

該階段在 access 階段以前執行，故名 preaccess.標準模塊 ngx_limit_req 和 ngx_limit_zone 就運行在此階段，前者能夠控制請求的訪問頻度，然後者能夠限制訪問的併發度。

七、access

標準模塊 ngx_access、第三方模塊 ngx_auth_request 以及第三方模塊 ngx_lua 的 access_by_lua 指令就運行在這個階段。

八、 post-access

這個階段也和 post-rewrite 階段相似，並不支持 Nginx 模塊註冊處理程序，而是由 Nginx 核心本身完成一些處理工做。post-access 階段主要用於配合 access 階段實現標準 ngx_http_core 模塊提供的配置指令 satisfy 的功能。對於多個 Nginx 模塊註冊在 access 階段的處理程序， satisfy 配置指令能夠用於控制它們彼此之間的協做方式。好比模塊 A 和 B 都在 access 階段註冊了與訪問控制相關的處理程序，那就有兩種協做方式，一是模塊 A 和模塊 B 都得經過驗證纔算經過，二是模塊 A 和模塊 B 只要其中任一個經過驗證就算經過。第一種協做方式稱爲 all 方式（或者說「與關係」），第二種方式則被稱爲 any 方式（或者說「或關係」）。默認狀況下，Nginx 使用的是 all 方式。

九、try-files

這個階段專門用於實現標準配置指令 try_files 的功能，並不支持 Nginx 模塊註冊處理程序。 try_files 指令接受兩個以上任意數量的參數，每一個參數都指定了一個 URI. 這裏假設配置了 N 個參數，則 Nginx 會在 try-files 階段，依次把前 N-1 個參數映射爲文件系統上的對象（文件或者目錄），而後檢查這些對象是否存在。一旦 Nginx 發現某個文件系統對象存在，就會在 try-files 階段把當前請求的 URI 改寫爲該對象所對應的參數 URI（但不會包含末尾的斜槓字符，也不會發生「內部跳轉」）。若是前 N-1 個參數所對應的文件系統對象都不存在，try-files 階段就會當即發起「內部跳轉」到最後一個參數（即第 N 個參數）所指定的 URI.經過 root 配置指令所指定的「文檔根目錄」進行映射。例如，當「文檔根目錄」是 /var/www/ 的時候，請求 URI /foo/bar 會被映射爲文件 /var/www/foo/bar，而請求 URI /foo/baz/ 則會被映射爲目錄 /var/www/foo/baz/. 注意這裏是如何經過 URI 末尾的斜槓字符是否存在來區分「目錄」和「文件」的。

十、content

Nginx 的 content 階段是全部請求處理階段中最爲重要的一個，由於運行在這個階段的配置指令通常都肩負着生成「內容」（content）並輸出 HTTP 響應的使命。正由於其重要性，這個階段的配置指令也異常豐富。echo、 Nginx 變量漫談（二）中接觸到的 echo_exec 指令， Nginx 變量漫談（三）中接觸到的 proxy_pass 指令， Nginx 變量漫談（五）中介紹過的 echo_location 指令，以及 Nginx 變量漫談（七）中介紹過的 content_by_lua。