第三方NGINX C模块能否在运行时动态添加FastCGI参数？

你完全可以通过第三方NGINX C模块动态添加FastCGI参数，核心思路是在FastCGI模块处理请求的前置阶段，修改其location配置中存储的FastCGI参数集合。以下是具体实现方案：

实现原理 #

NGINX的ngx_http_fastcgi_module会将配置中的fastcgi_param存储在location级别的配置结构体ngx_http_fastcgi_loc_conf_t的params数组中，在请求处理的CONTENT阶段，模块会遍历这个数组构建FastCGI请求的参数列表。第三方模块只需在FastCGI模块执行前，向这个数组中追加自定义参数即可。

具体实现步骤 #

1. 挂载模块到前置执行阶段 #

将第三方模块的请求处理器挂载到NGX_HTTP_PRECONTENT_PHASE，或者设置比FastCGI模块更高的优先级（FastCGI模块的优先级为NGX_HTTP_CONTENT_PRIORITY，可设置为NGX_HTTP_CONTENT_PRIORITY - 10），确保在FastCGI处理前执行。

2. 获取FastCGI的Location配置 #

在模块处理器中，通过ngx_http_get_module_loc_conf获取当前请求对应的FastCGI location配置：

ngx_http_fastcgi_loc_conf_t *flcf = ngx_http_get_module_loc_conf(r, ngx_http_fastcgi_module);
if (flcf == NULL || flcf->params == NULL) {
    return NGX_DECLINED; // 非FastCGI location，跳过处理
}

3. 构建并添加自定义参数 #

使用NGINX请求内存池分配参数结构体，设置参数名和值，然后追加到params数组：

// 定义要添加的参数
u_char *param_name = (u_char *)"MY_VAR";
size_t name_len = ngx_strlen(param_name);
u_char *param_value = (u_char *)"hello";
size_t value_len = ngx_strlen(param_value);

// 分配参数结构体内存
ngx_http_fastcgi_param_t *new_param = ngx_palloc(r->pool, sizeof(ngx_http_fastcgi_param_t));
if (new_param == NULL) {
    return NGX_HTTP_INTERNAL_SERVER_ERROR;
}

// 复制参数名到请求内存池
new_param->name.data = ngx_palloc(r->pool, name_len);
new_param->name.len = name_len;
ngx_memcpy(new_param->name.data, param_name, name_len);

// 复制参数值到请求内存池
new_param->value.data = ngx_palloc(r->pool, value_len);
new_param->value.len = value_len;
ngx_memcpy(new_param->value.data, param_value, value_len);

// 追加到params数组
if (ngx_array_push(flcf->params) == NULL) {
    return NGX_HTTP_INTERNAL_SERVER_ERROR;
}
((ngx_http_fastcgi_param_t *)flcf->params->elts)[flcf->params->nelts - 1] = *new_param;

4. 实现配置指令（可选） #

如果要像Apache SetEnv那样支持配置中定义参数，可以为模块添加自定义配置指令，将参数名和值存储到模块的location配置结构体中，再在请求处理器中批量读取并添加到FastCGI参数列表。

注意事项 #

• 参数去重：如果需要避免重复添加同名参数，可以遍历flcf->params数组，检查是否已存在同名参数，再决定是覆盖还是跳过。
• 内存管理：所有字符串和结构体必须使用NGINX的请求内存池（r->pool）分配，避免内存泄漏。
• 阶段顺序：确保模块处理器在FastCGI模块之前执行，否则修改的参数不会被FastCGI模块读取。

内容的提问来源于stack exchange，提问作者Imylor