Nginx學習之三-ngx_http_request_t結構體

摘自： http://blog.csdn.net/xiajun07061225/article/details/9189505 江雨煙雲的部落格

ngx_http_request_s是nginx中非常重要的一個結構體，貫穿於htpp請求處理的整個過程中。

下面解釋了ngx_http_request_s結構體中與HTTP架構相關的重要的成員變數。

[cpp] view plain copy print?

1. struct ngx_http_request_s {
2. uint32_t signature; /* "HTTP" */
4. //請求對應的用戶端串連
5. ngx_connection_t *connection;
7. //指向存放所有HTTP模組的上下文結構體的指標數組
8. void **ctx;
9. //指向請求對應的存放main層級配置結構體的指標數組
10. void **main_conf;
11. //指向請求對應的存放srv層級配置結構體的指標數組
12. void **srv_conf;
13. //指向請求對應的存放loc層級配置結構體的指標數組
14. void **loc_conf;
16. /*
17. * 在接收完http頭部，第一次在業務上處理http請求時，http架構提供的處理方法是ngx_http_process_request。
18. 但如果該方法無法一次處理完該請求的全部業務，在歸還控制權到epoll時間模組後，該請求再次被回調時，
19. 將通過Ngx_http_request_handler方法來處理，而這個方法中對於可讀事件的處理就是調用read_event_handler處理請求。
20. 也就是說，http模組希望在底層處理請求的讀事件時，重新實現read_event_handler方法
21. */
22. ngx_http_event_handler_pt read_event_handler;
23. //與上面的方法類似
24. ngx_http_event_handler_pt write_event_handler;
26. #if (NGX_HTTP_CACHE)
27. ngx_http_cache_t *cache;
28. #endif
30. //upstream機制用到的結構體
31. ngx_http_upstream_t *upstream;
32. ngx_array_t *upstream_states;
33. /* of ngx_http_upstream_state_t */
35. //這個請求的記憶體池
36. ngx_pool_t *pool;
37. //用於接收http請求內容的緩衝區，主要接收http頭部
38. ngx_buf_t *header_in;
40. //ngx_http_process_request_headers在接收、解析完http請求的頭部後，會把解析完的每一個http頭部加入到headers_in的headers鏈表中，同時會構造headers_in中的其他成員
41. ngx_http_headers_in_t headers_in;
42. //http模組會把想要發送的http相應資訊放到headers_out中，期望http架構將headers_out中的成員序列化為http響應包發送給使用者
43. ngx_http_headers_out_t headers_out;
45. //接收請求中包體的資料結構
46. ngx_http_request_body_t *request_body;
48. //延遲關閉串連的時間
49. time_t lingering_time;
50. //當前請求初始化時的時間
51. time_t start_sec;
52. ngx_msec_t start_msec;
54. //下面的9個成員是函數ngx_http_process_request_line方法在接收、解析http請求行時解析出的資訊
55. ngx_uint_t method;//方法名
56. ngx_uint_t http_version;//協議版本
58. ngx_str_t request_line;
59. ngx_str_t uri;//使用者請求中的uri
60. ngx_str_t args;//使用者請求中的url參數
61. ngx_str_t exten;//使用者請求的副檔名
62. ngx_str_t unparsed_uri;//沒有進行URL解碼的原始請求
64. ngx_str_t method_name;//使用者請求中的方法名字串
65. ngx_str_t http_protocol;//其data成員指向請求中http起始地址
67. /*表示需要發送給用戶端的http響應。out中儲存著由headers_out中序列化後的表示http頭部的TCP流。
68. * 在調用ngx_http_output_filter方法後，out中還會儲存著待發送的http包體，它是實現非同步發送http響應的關鍵。*/
69. ngx_chain_t *out;
70. /*當前請求既有可能是使用者發來的請求，也可能是派生出的子請求。
71. * 而main標識一系列相關的派生子請求的原始請求。
72. * 一般可通過main和當前請求的地址是否相等來判斷當前請求是否為使用者發來的原始請求。*/
73. ngx_http_request_t *main;
74. //當前請求的父請求（不一定是原始請求）
75. ngx_http_request_t *parent;
76. //與subrequest子請求相關的功能
77. ngx_http_postponed_request_t *postponed;
78. ngx_http_post_subrequest_t *post_subrequest;
79. //所有的子請求都是通過這個單鏈錶鏈接起來的
80. ngx_http_posted_request_t *posted_requests;
82. /*全域的ngx_http_phase_engine_t結構體中定義了一個ngx_http_phase_handler_t回答方法組成的數組。
83. * 而phase_handler成員則與該數組配合使用。表示請求下次應當執行phase_handler作為序號指定的數組中的回調方法*/
84. ngx_int_t phase_handler;
85. //表示NGX_HTTP_CONTENT_PHASE階段提供給http模組處理請求的一種方式，它指向http模組實現的請求處理方法
86. ngx_http_handler_pt content_handler;
87. //在NGX_HTTP_ACCESS_PHASE節點需要判斷請求是否具有存取權限時，通過access_code來傳遞http模組的handler回調方法的返回值，如果為0表示具備許可權。否則不具備。
88. ngx_uint_t access_code;
90. ngx_http_variable_value_t *variables;
92. #if (NGX_PCRE)
93. ngx_uint_t ncaptures;
94. int *captures;
95. u_char *captures_data;
96. #endif
98. size_t limit_rate;
100. /* used to learn the Apache compatible response length without a header */
101. size_t header_size;
103. //http請求的全部長度，包括http包體
104. off_t request_length;
106. ngx_uint_t err_status;
108. ngx_http_connection_t *http_connection;
109. #if (NGX_HTTP_SPDY)
110. ngx_http_spdy_stream_t *spdy_stream;
111. #endif
113. ngx_http_log_handler_pt log_handler;
115. //在這個請求中如果開啟了某些資源，並需要在請求結束時釋放，那麼需要把定義的釋放資源的方法添加到這個成員
116. ngx_http_cleanup_t *cleanup;
118. unsigned subrequests:8;
119. //引用計數一般都作用於這個請求的原始請求上
120. //引用計數，每當派生出子請求時，原始請求的count成員都會加一
121. unsigned count:8;
122. //阻塞標誌位，目前僅由aio使用
123. unsigned blocked:8;
125. //標誌位：為1表示蛋清請求正在使用非同步IO
126. unsigned aio:1;
128. unsigned http_state:4;
130. /* URI with "/." and on Win32 with "//" */
131. unsigned complex_uri:1;
133. /* URI with "%" */
134. unsigned quoted_uri:1;
136. /* URI with "+" */
137. unsigned plus_in_uri:1;
139. /* URI with " " */
140. unsigned space_in_uri:1;
142. unsigned invalid_header:1;
144. unsigned add_uri_to_alias:1;
145. unsigned valid_location:1;
146. unsigned valid_unparsed_uri:1;
147. //標誌位：為1時表示URL發生過rewrite重寫
148. unsigned uri_changed:1;
149. //表示使用rewrite重寫URL的次數
150. unsigned uri_changes:4;
152. unsigned request_body_in_single_buf:1;
153. unsigned request_body_in_file_only:1;
154. unsigned request_body_in_persistent_file:1;
155. unsigned request_body_in_clean_file:1;
156. unsigned request_body_file_group_access:1;
157. unsigned request_body_file_log_level:3;
159. unsigned subrequest_in_memory:1;
160. unsigned waited:1;
162. #if (NGX_HTTP_CACHE)
163. unsigned cached:1;
164. #endif
166. #if (NGX_HTTP_GZIP)
167. unsigned gzip_tested:1;
168. unsigned gzip_ok:1;
169. unsigned gzip_vary:1;
170. #endif
172. unsigned proxy:1;
173. unsigned bypass_cache:1;
174. unsigned no_cache:1;
176. /*
177. * instead of using the request context data in
178. * ngx_http_limit_conn_module and ngx_http_limit_req_module
179. * we use the single bits in the request structure
180. */
181. unsigned limit_conn_set:1;
182. unsigned limit_req_set:1;
184. #if 0
185. unsigned cacheable:1;
186. #endif
188. unsigned pipeline:1;
189. unsigned chunked:1;
190. unsigned header_only:1;
191. //標誌位，為1表示當前請求時keepalive請求
192. unsigned keepalive:1;
193. //延遲關閉標誌位
194. unsigned lingering_close:1;
195. //標誌位：為1表示正在丟棄http請求中的包體
196. unsigned discard_body:1;
197. //標誌位：為1表示請求的目前狀態是在做內部跳轉
198. unsigned internal:1;
199. unsigned error_page:1;
200. unsigned ignore_content_encoding:1;
201. unsigned filter_finalize:1;
202. unsigned post_action:1;
203. unsigned request_complete:1;
204. unsigned request_output:1;
205. //標誌位：為1表示發生給用戶端的http回應標頭已經發送
206. unsigned header_sent:1;
207. unsigned expect_tested:1;
208. unsigned root_tested:1;
209. unsigned done:1;
210. unsigned logged:1;
212. //標誌位，表示緩衝中是否有待發送內容
213. unsigned buffered:4;
215. unsigned main_filter_need_in_memory:1;
216. unsigned filter_need_in_memory:1;
217. unsigned filter_need_temporary:1;
218. unsigned allow_ranges:1;
220. #if (NGX_STAT_STUB)
221. unsigned stat_reading:1;
222. unsigned stat_writing:1;
223. #endif
225. /* used to parse HTTP headers */
227. //狀態機器解析http時使用state來表示當前的解析狀態，需要檢查是否構成完成的http請求行
228. ngx_uint_t state;
230. ngx_uint_t header_hash;
231. ngx_uint_t lowcase_index;
232. u_char lowcase_header[NGX_HTTP_LC_HEADER_LEN];
234. u_char *header_name_start;
235. u_char *header_name_end;
236. u_char *header_start;
237. u_char *header_end;
239. /*
240. * a memory that can be reused after parsing a request line
241. * via ngx_http_ephemeral_t
242. */
244. u_char *uri_start;
245. u_char *uri_end;
246. u_char *uri_ext;
247. u_char *args_start;
248. u_char *request_start;
249. u_char *request_end;
250. u_char *method_end;
251. u_char *schema_start;
252. u_char *schema_end;
253. u_char *host_start;
254. u_char *host_end;
255. u_char *port_start;
256. u_char *port_end;
258. unsigned http_minor:16;
259. unsigned http_major:16;
260. };

以上就介紹了 Nginx學習之三-ngx_http_request_t結構體，包括了方面的內容，希望對PHP教程有興趣的朋友有所協助。

