ngx_http_ssi_create_main_conf

在 src\http\modules\ngx_http_ssi_filter_module.c

static void *
ngx_http_ssi_create_main_conf(ngx_conf_t *cf)
{
    ngx_http_ssi_main_conf_t  *smcf;

    smcf = ngx_pcalloc(cf->pool, sizeof(ngx_http_ssi_main_conf_t));
    if (smcf == NULL) {
        return NULL;
    }

    smcf->commands.pool = cf->pool;
    smcf->commands.temp_pool = cf->temp_pool;

    if (ngx_hash_keys_array_init(&smcf->commands, NGX_HASH_SMALL) != NGX_OK) {
        return NULL;
    }

    return smcf;
}

函数作用

ngx_http_ssi_create_main_conf 是 Nginx 的 SSI（Server Side Includes）模块在配置阶段初始化主配置结构体的函数。

其核心功能是：

1. 分配并初始化主配置结构体 ngx_http_ssi_main_conf_t
2. 初始化哈希表，用于存储 SSI 命令到处理函数的映射关系，以便在运行时快速查找和执行相应指令。

在 Nginx 的 SSI（Server Side Includes）模块中，commands 字段是一个关键的结构体成员，用于存储和管理 SSI 命令到处理函数的映射关系。

它通过哈希表（Hash Table）实现快速查找，是 SSI 模块高效处理指令的核心机制。

ngx_hash_keys_array_init

初始化哈希表的 键数组 和 桶数组的内存空间，为后续添加键值对（如 SSI 命令到处理函数的映射）做准备。

参数：

### `&smcf->commands`：指向 `ngx_hash_keys_t` 类型的结构体指针，表示需要初始化的哈希表。

### `NGX_HASH_SMALL`：宏定义的哈希表配置参数，通常指定哈希表的初始大小

#define NGX_HASH_SMALL            1

返回值：

### `NGX_OK`：初始化成功。

### `NGX_ERROR`：初始化失败（如内存不足）。

ngx_hash_keys_array_init

ngx_hash_keys_array_init-CSDN博客

---