Ubuntu 下 nginx-1.24.0 源码分析 - ngx_core_module_t

`ngx_core_module_t`

定义在 src/core/ngx_module.h

c 复制代码

typedef struct {
    ngx_str_t             name;
    void               *(*create_conf)(ngx_cycle_t *cycle);
    char               *(*init_conf)(ngx_cycle_t *cycle, void *conf);
} ngx_core_module_t;

ngx_core_module_t 是 Nginx 核心模块的关键结构体，用于定义核心模块的配置管理行为。以下是对该结构体及其成员的详细解释：

结构体作用

ngx_core_module_t 为核心模块提供统一的接口，使 Nginx 框架能够：

识别模块 ：通过 name 字段标识模块。
管理配置生命周期 ：通过 create_conf 和 init_conf 回调函数，在配置解析的不同阶段创建和初始化模块的配置结构。

成员详解

1. `ngx_str_t name`

作用：存储模块的名称（如 "core"、"event"）。
意义：
- 在日志、调试或配置解析时标识模块。
- 作为模块的唯一标识符，用于框架内部的模块管理。

数据结构 ：

c 复制代码

typedef struct {
    size_t      len;    // 字符串长度
    u_char     *data;   // 字符串数据（以 NULL 结尾）
} ngx_str_t;

**2. `void (create_conf)(ngx_cycle_t *cycle)`**

作用：回调函数，用于创建模块的配置结构。
调用时机：在解析配置文件前被 Nginx 框架调用。
功能：
- 为模块分配配置结构的内存（通常使用内存池 cycle->pool）。
- 初始化配置结构的默认值（如设置默认的工作进程数、超时时间等）。

**3. `char (init_conf)(ngx_cycle_t cycle, void conf)`**

作用：回调函数，用于验证和调整配置。
调用时机：在配置解析完成后被调用。
功能：
- 验证配置的合法性（如检查必填项是否缺失）。
- 合并或调整配置值（如将相对路径转换为绝对路径）。
- 返回错误信息（若配置无效）。
返回值 ：
- NULL：配置有效。
- 非 NULL：指向错误信息字符串（Nginx 启动失败并输出该信息）。

整体流程

模块注册 ：核心模块通过定义 ngx_core_module_t 实例注册到 Nginx。
配置创建 ：Nginx 调用 create_conf 为模块分配配置结构。
配置解析：解析配置文件，填充配置结构。
配置验证 ：调用 init_conf 检查配置合法性。
启动/错误处理 ：若 init_conf 返回错误，Nginx 终止启动并输出错误信息。

核心模块与普通模块的区别

核心模块 ：使用 ngx_core_module_t，负责基础功能（如进程管理、事件处理）。
普通模块 ：使用 ngx_module_t，实现扩展功能（如 HTTP 处理模块）。

示例场景

以 core 模块为例：

create_conf ：创建 ngx_core_conf_t 结构，设置 daemon、master_process 等默认值。
init_conf ：检查 pid 文件路径是否有效，合并主配置与子配置。

总结

ngx_core_module_t 通过标准化核心模块的配置管理，实现了模块与框架的解耦，使 Nginx 能够高效地处理配置的创建、解析和验证，是模块化架构的核心设计之一。