ngx_module_t是Nginx模块的核心结构体，包含context（上下文指针）、commands（配置指令数组）、init_*（生命周期钩子）和元信息（type/name等）四部分，共同决定模块类型、配置解析、初始化时机与身份标识。

要开发 Nginx 模块，必须理解 ngx_module_t 这个核心结构体——它是模块的“身份证”和“行为说明书”，Nginx 启动时靠它识别模块类型、注册钩子、初始化资源。

module context：模块上下文指针，决定模块归属与行为模式

该成员是一个 void 指针，实际指向某类模块特有的上下文结构，比如 ngx_http_module_t（HTTP 模块）、ngx_core_module_t（核心模块）、ngx_event_module_t（事件模块）等。Nginx 通过它区分模块职责，并在对应阶段调用其回调函数。

• HTTP 模块必须设为 &ngx_http_core_module 或自定义的 ngx_http_module_t 实例
• 核心模块（如 ngx_core_module）用 ngx_core_module_t，负责配置解析、进程管理等全局逻辑
• 值为 NULL 表示该模块无上下文逻辑（如某些纯指令模块），但不推荐省略

commands：模块支持的配置指令数组，驱动配置解析流程

这是一个 ngx_command_t 类型的静态数组，以 { 0 } 结尾。每条指令定义名称、类型、参数个数、配置作用域、读取/设置回调等关键信息。

• name 是配置文件中出现的指令名（如 my_directive）
• type 标明指令生效位置（NGX_HTTP_MAIN_CONF 表示仅在 http 块可用）
• set 回调是真正处理配置值的地方，接收 cf（配置上下文）、cmd（当前指令）、conf（模块配置内存地址）三个参数
• 若无自定义指令，可设为 NULL，但多数功能模块都需要至少一条

init_master / init_module / init_process：生命周期三阶段钩子

这三个函数指针分别在 master 进程启动、模块加载、worker 进程初始化时被调用，用于执行不同粒度的初始化操作。

• init_master：仅 master 进程执行一次，适合做全局资源预分配（如共享内存初始化）
• init_module：所有进程加载模块时调用，常用于注册信号、初始化静态变量
• init_process：每个 worker 进程启动时调用，最常用——建立连接池、初始化线程局部存储、打开 epoll 等
• 不需要某个阶段时，直接设为 NULL 即可，Nginx 会跳过

type / ctx_index / index / name：模块元信息，影响调度与兼容性

这些字段共同构成模块的“身份标识”，由 Nginx 内部使用，开发者需按规范填写。

• type 必须设为 NGX_HTTP_MODULE、NGX_CORE_MODULE 等宏之一，决定模块挂载位置
• ctx_index 和 index 是整型索引，用于快速定位模块及其上下文；HTTP 模块通常由 Nginx 自动分配，手动开发建议设为 NGX_CONF_UNSET_UINT
• name 是字符串指针（如 ngx_string("ngx_http_myfilter_module")），用于日志、调试和错误提示

掌握这四个维度的成员，就能写出结构正确、可被 Nginx 正常加载和调用的基础模块。后续指令解析、配置合并、HTTP 处理阶段挂载，都建立在这个结构体扎实定义之上。