nginx核心结构

ngx_cycle_s

    struct ngx_cycle_s {
        void                  ****conf_ctx; // 配置数据的起始存储位置
        ngx_pool_t               *pool;

        ngx_log_t                *log;
        ngx_log_t                 new_log;

        ngx_uint_t                log_use_stderr;  /* unsigned  log_use_stderr:1; */

        ngx_connection_t        **files;
        ngx_connection_t         *free_connections;
        ngx_uint_t                free_connection_n;

        ngx_module_t            **modules;      // 运行时模块指针数组
        ngx_uint_t                modules_n;    // 模块数量
        ngx_uint_t                modules_used;    /* 模块是否已加载的标志位 unsigned  modules_used:1; */

        ngx_queue_t               reusable_connections_queue;
        ngx_uint_t                reusable_connections_n;

        ngx_array_t               listening;
        ngx_array_t               paths;

        ngx_array_t               config_dump;
        ngx_rbtree_t              config_dump_rbtree;
        ngx_rbtree_node_t         config_dump_sentinel;

        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;
    };

• modules 数组仅仅起到集中所有模块的作用，模块的层次和调用关系由数据结构里的ctx_index、index和各种指针实现。

ngx_module_t 模块定义

define NGX_MODULE_V1                                                         \
NGX_MODULE_UNSET_INDEX, NGX_MODULE_UNSET_INDEX,  NULL, 0, 0, nginx_version, NGX_MODULE_SIGNATURE
define NGX_MODULE_V1_PADDING  0, 0, 0, 0, 0, 0, 0, 0

typedef struct ngx_module_s      ngx_module_t;
struct ngx_module_s {
    ngx_uint_t            ctx_index;    // 在type类数组里的序号
    ngx_uint_t            index;        // 在全种类数组里的序号

    char                 *name;

    ngx_uint_t            spare0;
    ngx_uint_t            spare1;

    ngx_uint_t            version;
    const char           *signature;    // 签名，特征码，Nginx把硬件体系、编译环境、操作系统、底层调用等信息转换成个特征字符串，主程序和模块都有这个签名，在动态加载模块的时候就对比这个签名，如果一致就表示兼容，可以正确加载，否则不能。

    void                 *ctx;
    ngx_command_t        *commands;
    ngx_uint_t            type;

    ngx_int_t           (*init_master)(ngx_log_t *log); // 初始化master进程时候进行调用

    ngx_int_t           (*init_module)(ngx_cycle_t *cycle); // 在模块初始化的时候调用，启动worker子进程前完成

    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;  // 保留字段，暂时无用
};

• type的种类就是六大核心模块选择：NGX_CORE_MODULE、NGX_EVENT_MODULE、NGX_HTTP_MODULE、NGX_STREAM_MODULE、NGX_MAIL_MODULE。stream是处理四层的模块。

ngx_http_conf_ctx_t

    typedef struct {
        void        **main_conf;
        void        **srv_conf;
        void        **loc_conf; // 都是void* 数组，这里的void* 存储的是回调函数(如create_loc_conf()) 返回的结果，也就是自定义的配置信息
    } ngx_http_conf_ctx_t;

• 存储三个层次的配置信息

• 这里的void* 存储的是回调函数(如create_loc_conf()) 返回的结果，也就是自定义的配置信息

ngx_conf_s

struct ngx_conf_s {
    char                 *name;
    ngx_array_t          *args; // 配置文件中的指令信息，args[0]是指令本身，之后是参数

    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_http_conf_ctx_t
    ngx_uint_t            module_type;
    ngx_uint_t            cmd_type;

    ngx_conf_handler_pt   handler;
    void                 *handler_conf;
};

• 解析配置文件时的重要数据结构，表示解析当前配置命令时的运行环境（Context）。

ngx_command_s

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;
    void                 *post;
};

• type 是设置作用域或参数数量等信息

ngx_http_module_t

typedef struct {
    ngx_int_t   (*preconfiguration)(ngx_conf_t *cf);
    ngx_int_t   (*postconfiguration)(ngx_conf_t *cf);

    void       *(*create_main_conf)(ngx_conf_t *cf);
    char       *(*init_main_conf)(ngx_conf_t *cf, void *conf);

    void       *(*create_srv_conf)(ngx_conf_t *cf);
    char       *(*merge_srv_conf)(ngx_conf_t *cf, void *prev, void *conf);  // 最后post前执行，合并配置，高层次的值作为默认值赋给低层次，合并操作通常是逐个检查当前结构里的值，如果未设置，就默认使用高层次的，如果设置了，就使用当前的

    void       *(*create_loc_conf)(ngx_conf_t *cf);
    char       *(*merge_loc_conf)(ngx_conf_t *cf, void *prev, void *conf);
} ngx_http_module_t;

• 合并配置，高层次的值作为默认值赋给低层次，合并操作通常是逐个检查当前结构里的值，如果未设置，就默认使用高层次的，如果设置了，就使用当前的。也就是底层次设置优先。