nginx 整体结构

       零零碎碎的看了nginx的源码，自己感觉还是比较的乱，所以花点时间把它的整体结构给理下,

 

 

 

 

 

      一   模块的结构(ngx_module_t)

 

     struct ngx_module_s { ngx_uint_t ctx_index; //分类索引，在该类别下模块中的索引号，现在系统core、event、http和mail四种模块 ngx_uint_t index; //模块的索引,表示该模块在所有模块中的下标 ngx_uint_t spare0; ngx_uint_t spare1; ngx_uint_t spare2; ngx_uint_t spare3; ngx_uint_t version; void *ctx; ngx_command_t *commands; ngx_uint_t type; ngx_int_t (*init_master)(ngx_log_t *log); ngx_int_t (*init_module)(ngx_cycle_t *cycle); ngx_int_t (*init_process)(ngx_cycle_t *cycle); ngx_int_t (*init_thread)(ngx_cycle_t *cycle); void (*exit_thread)(ngx_cycle_t *cycle); void (*exit_process)(ngx_cycle_t *cycle); void (*exit_master)(ngx_cycle_t *cycle); uintptr_t spare_hook0; uintptr_t spare_hook1; uintptr_t spare_hook2; uintptr_t spare_hook3; uintptr_t spare_hook4; uintptr_t spare_hook5; uintptr_t spare_hook6; uintptr_t spare_hook7; };

 

      index 是指模块的下标，系统在初始化的是，给了每个模块一个唯一id,就好比每个学生都有一个学号，每个员工都有一个工号，下标从0开始。

 

      ctx   是模块的上下文，不同的模块具有不同的上下文，这个具体在第二部分介绍

 

      command  处理指令，在配置文件中的每条指令，在模块中都有对应的处理，因为每个模块可以有多个指令，所以这里可以存放多个指令处理的指令

 

      其它暂时不介绍。

 

 

      二  模块上下文(ngx_xxx_module_ctx) 

           这里的xxx表示模块的类型(core、 event 、http、email)

 

      name 模块上下文的名字

 

      ngx_xxx_module_create_conf   模块配置的创建函数，这个函数创建的模块配置需要保存在 conf_ctx中的，那么放到那里呢？就是通过模块的index来定位的: cycle->conf_ctx[ngx_modules[i]->index] = rv;  (ngx_cycle.c: ngx_init_cycle()函数)

       ngx_xxx_module_init_conf        模块配置的初始化函数

 

      注意：不是每个模块都有上面的函数的，有些模块(event, http) 没有配置信息，那就不用这两个函数的。

 

        三  模块的配置 conf_ctx 

 

        这里面只是存放了指向各个模块conf的指针，各个模块的指针根据他们的index 有序存放。

 

        系统的配置结果 ngx_conf_t 和cycle 都有成员指向这个结构，这样便于获取模块的配置信息

 

        四  模块指令(ngx_command)

  struct ngx_command_s { ngx_str_t name; ngx_uint_t type; char *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf); ngx_uint_t conf; ngx_uint_t offset; //set函数需要设置的值在整个结构中的地址 void *post; };

 

         name 模块指令的名称

 

         type  模块的类型，这个比较的复杂，我还没有看懂

 

         set(cf, cmd ,conf)  设置的函数，所有工作都是在这个函数中完成的，不同模块的不同指令，都有不同的函数

 

         conf  这个是定位到那个被赋值模块的配置，但是不是所有的模块会使用这个变量的，一般的模块直接通过index 就定位到了的，具体是什么样的情况使用这个，还需要深入的看下。

 

         offset  这个是被赋值模块的配置内部的下标。 

 

         post   不知知道

 

         总的来说，模块指令完成类似下面的工作      *(config  +  offset) = cf->args ,对找到模块内的制定位置赋值。

 

 

        五 全局数据(ngx_cycle_t)

 

        这个保存了系统的全局数据，在整个程序执行过程中，都会使用到

 

        struct ngx_cycle_s { void ****conf_ctx; ngx_pool_t *pool; ngx_log_t *log; ngx_log_t new_log; ngx_connection_t **files; //存放socket和connection之间的关系 ngx_connection_t *free_connections; ngx_uint_t free_connection_n; ngx_array_t listening; ngx_array_t pathes; ngx_list_t open_files; ngx_list_t shared_memory; ngx_uint_t connection_n; ngx_uint_t files_n; ngx_connection_t *connections; ngx_event_t *read_events; ngx_event_t *write_events; ngx_cycle_t *old_cycle; ngx_str_t conf_file; ngx_str_t conf_param; ngx_str_t conf_prefix; ngx_str_t prefix; ngx_str_t lock_file; ngx_str_t hostname; };

 

        conf_ctx  指向的就是模块的配置信息

 

        六   指令参数 ngx_conf_t

        这里存放了从配置文件中读取的，需要传给模块配置信息的数据。

        struct ngx_conf_s { char *name; ngx_array_t *args; //指令参数，从文件读入，直接放入这个数组 ngx_cycle_t *cycle; // ngx_pool_t *pool; ngx_pool_t *temp_pool; ngx_conf_file_t *conf_file; ngx_log_t *log; void *ctx; ngx_uint_t module_type; ngx_uint_t cmd_type; ngx_conf_handler_pt handler; char *handler_conf; };