Nginx学习之三-ngx_http_request_t结构体
ngx_http_request_s是nginx中非常重要的一个结构体,贯穿于htpp请求处理的整个过程中。
下面解释了ngx_http_request_s结构体中与HTTP框架相关的重要的成员变量。
- struct ngx_http_request_s {
- uint32_t signature; /* "HTTP" */
- //请求对应的客户端连接
- ngx_connection_t *connection;
- //指向存放所有HTTP模块的上下文结构体的指针数组
- void **ctx;
- //指向请求对应的存放main级别配置结构体的指针数组
- void **main_conf;
- //指向请求对应的存放srv级别配置结构体的指针数组
- void **srv_conf;
- //指向请求对应的存放loc级别配置结构体的指针数组
- void **loc_conf;
- /*
- * 在接收完http头部,第一次在业务上处理http请求时,http框架提供的处理方法是ngx_http_process_request。
- 但如果该方法无法一次处理完该请求的全部业务,在归还控制权到epoll时间模块后,该请求再次被回调时,
- 将通过Ngx_http_request_handler方法来处理,而这个方法中对于可读事件的处理就是调用read_event_handler处理请求。
- 也就是说,http模块希望在底层处理请求的读事件时,重新实现read_event_handler方法
- */
- ngx_http_event_handler_pt read_event_handler;
- //与上面的方法类似
- ngx_http_event_handler_pt write_event_handler;
- #if (NGX_HTTP_CACHE)
- ngx_http_cache_t *cache;
- #endif
- //upstream机制用到的结构体
- ngx_http_upstream_t *upstream;
- ngx_array_t *upstream_states;
- /* of ngx_http_upstream_state_t */
- //这个请求的内存池
- ngx_pool_t *pool;
- //用于接收http请求内容的缓冲区,主要接收http头部
- ngx_buf_t *header_in;
- //ngx_http_process_request_headers在接收、解析完http请求的头部后,会把解析完的每一个http头部加入到headers_in的headers链表中,同时会构造headers_in中的其他成员
- ngx_http_headers_in_t headers_in;
- //http模块会把想要发送的http相应信息放到headers_out中,期望http框架将headers_out中的成员序列化为http响应包发送给用户
- ngx_http_headers_out_t headers_out;
- //接收请求中包体的数据结构
- ngx_http_request_body_t *request_body;
- //延迟关闭连接的时间
- time_t lingering_time;
- //当前请求初始化时的时间
- time_t start_sec;
- ngx_msec_t start_msec;
- //下面的9个成员是函数ngx_http_process_request_line方法在接收、解析http请求行时解析出的信息
- ngx_uint_t method;//方法名
- ngx_uint_t http_version;//协议版本
- ngx_str_t request_line;
- ngx_str_t uri;//用户请求中的uri
- ngx_str_t args;//用户请求中的url参数
- ngx_str_t exten;//用户请求的文件扩展名
- ngx_str_t unparsed_uri;//没有进行URL解码的原始请求
- ngx_str_t method_name;//用户请求中的方法名字符串
- ngx_str_t http_protocol;//其data成员指向请求中http起始地址
- /*表示需要发送给客户端的http响应。out中保存着由headers_out中序列化后的表示http头部的TCP流。
- * 在调用ngx_http_output_filter方法后,out中还会保存着待发送的http包体,它是实现异步发送http响应的关键。*/
- ngx_chain_t *out;
- /*当前请求既有可能是用户发来的请求,也可能是派生出的子请求。
- * 而main标识一系列相关的派生子请求的原始请求。
- * 一般可通过main和当前请求的地址是否相等来判断当前请求是否为用户发来的原始请求。*/
- ngx_http_request_t *main;
- //当前请求的父请求(不一定是原始请求)
- ngx_http_request_t *parent;
- //与subrequest子请求相关的功能
- ngx_http_postponed_request_t *postponed;
- ngx_http_post_subrequest_t *post_subrequest;
- //所有的子请求都是通过这个单链表链接起来的
- ngx_http_posted_request_t *posted_requests;
- /*全局的ngx_http_phase_engine_t结构体中定义了一个ngx_http_phase_handler_t回答方法组成的数组。
- * 而phase_handler成员则与该数组配合使用。表示请求下次应当执行phase_handler作为序列号指定的数组中的回调方法*/
- ngx_int_t phase_handler;
- //表示NGX_HTTP_CONTENT_PHASE阶段提供给http模块处理请求的一种方式,它指向http模块实现的请求处理方法
- ngx_http_handler_pt content_handler;
- //在NGX_HTTP_ACCESS_PHASE节点需要判断请求是否具有访问权限时,通过access_code来传递http模块的handler回调方法的返回值,如果为0表示具备权限。否则不具备。
- ngx_uint_t access_code;
- ngx_http_variable_value_t *variables;
- #if (NGX_PCRE)
- ngx_uint_t ncaptures;
- int *captures;
- u_char *captures_data;
- #endif
- size_t limit_rate;
- /* used to learn the Apache compatible response length without a header */
- size_t header_size;
- //http请求的全部长度,包括http包体
- off_t request_length;
- ngx_uint_t err_status;
- ngx_http_connection_t *http_connection;
- #if (NGX_HTTP_SPDY)
- ngx_http_spdy_stream_t *spdy_stream;
- #endif
- ngx_http_log_handler_pt log_handler;
- //在这个请求中如果打开了某些资源,并需要在请求结束时释放,那么需要把定义的释放资源的方法添加到这个成员
- ngx_http_cleanup_t *cleanup;
- unsigned subrequests:8;
- //引用计数一般都作用于这个请求的原始请求上
- //引用计数,每当派生出子请求时,原始请求的count成员都会加一
- unsigned count:8;
- //阻塞标志位,目前仅由aio使用
- unsigned blocked:8;
- //标志位:为1表示蛋清请求正在使用异步IO
- unsigned aio:1;
- unsigned http_state:4;
- /* URI with "/." and on Win32 with "//" */
- unsigned complex_uri:1;
- /* URI with "%" */
- unsigned quoted_uri:1;
- /* URI with "+" */
- unsigned plus_in_uri:1;
- /* URI with " " */
- unsigned space_in_uri:1;
- unsigned invalid_header:1;
- unsigned add_uri_to_alias:1;
- unsigned valid_location:1;
- unsigned valid_unparsed_uri:1;
- //标志位:为1时表示URL发生过rewrite重写
- unsigned uri_changed:1;
- //表示使用rewrite重写URL的次数
- unsigned uri_changes:4;
- unsigned request_body_in_single_buf:1;
- unsigned request_body_in_file_only:1;
- unsigned request_body_in_persistent_file:1;
- unsigned request_body_in_clean_file:1;
- unsigned request_body_file_group_access:1;
- unsigned request_body_file_log_level:3;
- unsigned subrequest_in_memory:1;
- unsigned waited:1;
- #if (NGX_HTTP_CACHE)
- unsigned cached:1;
- #endif
- #if (NGX_HTTP_GZIP)
- unsigned gzip_tested:1;
- unsigned gzip_ok:1;
- unsigned gzip_vary:1;
- #endif
- unsigned proxy:1;
- unsigned bypass_cache:1;
- unsigned no_cache:1;
- /*
- * instead of using the request context data in
- * ngx_http_limit_conn_module and ngx_http_limit_req_module
- * we use the single bits in the request structure
- */
- unsigned limit_conn_set:1;
- unsigned limit_req_set:1;
- #if 0
- unsigned cacheable:1;
- #endif
- unsigned pipeline:1;
- unsigned chunked:1;
- unsigned header_only:1;
- //标志位,为1表示当前请求时keepalive请求
- unsigned keepalive:1;
- //延迟关闭标志位
- unsigned lingering_close:1;
- //标志位:为1表示正在丢弃http请求中的包体
- unsigned discard_body:1;
- //标志位:为1表示请求的当前状态是在做内部跳转
- unsigned internal:1;
- unsigned error_page:1;
- unsigned ignore_content_encoding:1;
- unsigned filter_finalize:1;
- unsigned post_action:1;
- unsigned request_complete:1;
- unsigned request_output:1;
- //标志位:为1表示发生给客户端的http响应头已经发送
- unsigned header_sent:1;
- unsigned expect_tested:1;
- unsigned root_tested:1;
- unsigned done:1;
- unsigned logged:1;
- //标志位,表示缓冲中是否有待发送内容
- unsigned buffered:4;
- unsigned main_filter_need_in_memory:1;
- unsigned filter_need_in_memory:1;
- unsigned filter_need_temporary:1;
- unsigned allow_ranges:1;
- #if (NGX_STAT_STUB)
- unsigned stat_reading:1;
- unsigned stat_writing:1;
- #endif
- /* used to parse HTTP headers */
- //状态机解析http时使用state来表示当前的解析状态,需要检查是否构成完成的http请求行
- ngx_uint_t state;
- ngx_uint_t header_hash;
- ngx_uint_t lowcase_index;
- u_char lowcase_header[NGX_HTTP_LC_HEADER_LEN];
- u_char *header_name_start;
- u_char *header_name_end;
- u_char *header_start;
- u_char *header_end;
- /*
- * a memory that can be reused after parsing a request line
- * via ngx_http_ephemeral_t
- */
- u_char *uri_start;
- u_char *uri_end;
- u_char *uri_ext;
- u_char *args_start;
- u_char *request_start;
- u_char *request_end;
- u_char *method_end;
- u_char *schema_start;
- u_char *schema_end;
- u_char *host_start;
- u_char *host_end;
- u_char *port_start;
- u_char *port_end;
- unsigned http_minor:16;
- unsigned http_major:16;
- };
Nginx学习之三-ngx_http_request_t结构体的更多相关文章
- nginx的ngx_http_request_t结构体
struct ngx_http_request_s { uint32_t signature; /* "HTTP" */ //请求对应的客户端连接 ngx_connection_t ...
- C#学习笔记之结构体
1.概述 结构是一种与类相似的数据类型,不过它较类更为轻量,一般适用于表示类似Point.Rectangle.Color的对象.基本上结构能办到的类全都能办到,但在某些情况下使用结构更为合适,后面会有 ...
- Swift学习之类和结构体的创建
随着一步步的学习,学习到的新知识越来越多了,不管是新的还是旧的,都禁不住时间的堆积,再熟悉的知识点时间久了都会渐渐的忘记,也许这就是人们生活中一种潜在的惰性吧,看似非常熟悉的东西,等到真正要用的时候, ...
- C++容器学习,与结构体排序和set来一场邂逅
最近学习C++容器,积累一下.下面介绍set和multiset,并使用sort对结构体进行排序.C++之路漫漫其修远兮! 一.对结构体进行排序 // sort_struct.cpp : 定义控制台应用 ...
- contiki学习笔记---process结构体
process,字面意义,进程,看看它的结构 struct process { struct process *next; #if PROCESS_CONF_NO_PROCESS_NAMES #def ...
- iOS学习06C语言结构体
1.结构体的概述 在C语言中,结构体(struct)指的是一种数据结构,是C语言中构造类型的其中之一. 在实际应用中,我们通常需要由不同类型的数据来构成一个整体,比如学生这个整体可以由姓名.年龄.身高 ...
- 《PHP7底层设计与源码实现》学习笔记2——结构体对齐
书里给了一段代码,假如有个结构体如下: struct test { char a; int b; long c; void* d; int e; cha ...
- c语言学习笔记之结构体存储
今天讲讲结构体存储问题 首先,结构体简单说是对不同类型的封装,一开始我们可能会想结构体在内存中的存储的大小是直接元素的和 例如 我们可能会觉得是 结构体大小=int(4个字节)+ short(2个字节 ...
- C语言学习笔记--枚举&结构体
枚举 枚举是一种用户定义的数据类型,它用关键字enum以如下语法格式来声明: enum 枚举类型名字 {名字0,名字1,...,名字n}: 枚举类型名字通常并不真的使用,要用的是大括号里面的名字,因为 ...
随机推荐
- 远程访问TeamTalk的Mysql数据库被拒解决方法
1.A Database Error Occurred 问题如图: 蓝狐给的解答是: 这是访问mysql出错了.解决办法参考:http://www.bkjia.com/jingyan/512248.h ...
- Parallel并行编程
Parallel并行编程 Parallel并行编程可以让我们使用极致的使用CPU.并行编程与多线程编程不同,多线程编程无论怎样开启线程,也是在同一个CPU上切换时间片.而并行编程则是多CPU核心同时工 ...
- MongoDB insert performance rapidly dropping
http://dba.stackexchange.com/questions/65554/mongodb-insert-performance-rapidly-dropping http://www. ...
- 有意思的GacUI
所有方法,无论是你写还是工具来codegen还是用宏,最终都指向把这些名字和对应的指针存在一个map里.C++是不提供这个功能的,我也没仔细研究过qt怎么做,不过我在我自己的gacui里面实现了类似的 ...
- Html辅助方法 之 Form表单标签
一.Html.BeginForm <form>标签 //视图代码@using (Html.BeginForm("search", "home", F ...
- C# System.Object基类
System.Object 基类 System.Object在.Net中是所有类型的基类,任何类型都直接或间接地继承自System.Object.没有指定基类的类型都默认继承于System.Objec ...
- mysql select不使用任何锁(select with nolock)
在ms sql中可以通过with(nolock)选项指定查询不锁表,在mysql中没有这个选项,需要通过set语句来设置不锁表: SET TRANSACTION ISOLATION LEVEL REA ...
- 关于Winsock编程中IO重叠的概念
我在看<Windows网络与通信程序设计>(王艳平)这本书时,对重叠IO很不理解,突然就冒出这么一个概念,没一点头绪.就目前的理解做一个整理. 第一种理解:OVERLAPPED,顾名思义为 ...
- Eclipse设置分级折叠显示项目工程路径
1.抛出问题现象 如下图,这种方式看项目中的代码简直痛苦的要死: 项目迭代越多,工程目录越庞大,可读性就越差. 2.设置分级折叠显示项目 第一步:在Package Explorer视图中找到它的缩放菜 ...
- 剑指offer-面试题15.链表中倒数第k个结点
题目:输入一个链表,输出该链表的倒数第K个结点.为了符合大多数人的习惯,本题 从1开始计数,即链表的尾结点是倒数第1个节点.例如有一个链表有6个节点,从 头节点开始他们的值依次是1,2,3,4,5,6 ...