C 语言 Web 开发实战：CGI、FastCGI 与 Nginx 模块详解

这里有个常见的坑：环境变量可能为 NULL，直接解引用会导致崩溃。另外，URL 解码函数必须健壮，防止缓冲区溢出。资源泄漏也是 CGI 程序的大敌，记得及时释放动态分配的内存。

FastCGI：持久化带来的性能飞跃

为了解决 CGI 每次请求都重启进程的问题，FastCGI 应运而生。它允许 CGI 进程保持驻留，通过 socket 或管道与 Web 服务器通信。这意味着进程初始化只发生一次，后续请求复用同一进程，性能提升显著。

FastCGI 的核心在于 FCGI_Accept() 循环。只要这个函数返回非负值，就说明有请求待处理。

#include <fcgi_stdio.h>
#include <stdlib.h>

int main() {
    while (FCGI_Accept() >= 0) {
        // 设置 HTTP 响应头
        printf("Content-Type: text/plain\n\n");
        // 输出响应内容
        printf("Hello from FastCGI!");
    }
    return 0;
}

处理参数的逻辑与 CGI 类似，只是包裹在 while(FCGI_Accept()) 循环内。这样同一个进程可以连续处理多个请求，直到被信号终止或达到最大连接数。

Nginx 模块：深入内核的定制开发

如果你需要极致的性能控制，或者想扩展 Nginx 的功能，编写 C 语言模块是最直接的方式。Nginx 基于事件驱动模型，使用内存池管理资源，多线程安全要求极高。

创建一个简单的 Nginx 模块，需要定义模块上下文、命令配置以及请求处理函数。下面是一个最简单的 Hello World 模块实现。

#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>

static ngx_int_t ngx_http_hello_handler(ngx_http_request_t *r);

static ngx_command_t ngx_http_hello_commands[] = {
    {ngx_string("hello_world"), NGX_HTTP_LOC_CONF | NGX_CONF_NOARGS,
     ngx_conf_set_flag_slot, NGX_HTTP_LOC_CONF_OFFSET, 0, NULL},
    ngx_null_command
};

static ngx_http_module_t ngx_http_hello_module_ctx = {
    NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL
};

ngx_module_t ngx_http_hello_module = {
    NGX_MODULE_V1,
    &ngx_http_hello_module_ctx,
    ngx_http_hello_commands,
    NGX_HTTP_MODULE,
    NULL, NULL, NULL, NULL,
    NULL, NULL, NULL, NGX_MODULE_V1_PADDING
};

static ngx_int_t ngx_http_hello_handler(ngx_http_request_t *r) {
    ngx_int_t rc;
    ngx_buf_t *b;
    ngx_chain_t out;

    // 设置响应头
    r->headers_out.content_type.len = sizeof("text/plain") - 1;
    r->headers_out.content_type.data = (u_char *)"text/plain";
    r->headers_out.status = NGX_HTTP_OK;
    r->headers_out.content_length_n = 13;

    // 发送响应头
    rc = ngx_http_send_header(r);
    if (rc == NGX_ERROR || rc > NGX_OK || r->header_only) {
        return rc;
    }

    // 准备响应内容
    b = ngx_pcalloc(r->pool, sizeof(ngx_buf_t));
    if (b == NULL) {
        return NGX_HTTP_INTERNAL_SERVER_ERROR;
    }
    out.buf = b;
    out.next = NULL;
    b->pos = (u_char *)"Hello from Nginx!";
    b->last = b->pos + 13;
    b->memory = 1;
    b->last_buf = 1;

    // 发送响应内容
    return ngx_http_output_filter(r, &out);
}

static ngx_int_t ngx_http_hello_init(ngx_conf_t *cf) {
    ngx_http_handler_pt *h;
    ngx_http_core_loc_conf_t *clcf;
    clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);
    h = ngx_array_push(&clcf->handlers);
    if (h == NULL) {
        return NGX_ERROR;
    }
    *h = ngx_http_hello_handler;
    return NGX_OK;
}

// 注意：实际编译需链接 nginx 库并正确配置 Makefile

编写 Nginx 模块时，内存管理完全依赖 ngx_pool，不要直接使用 malloc/free，否则会导致内存泄漏或冲突。线程安全方面，Nginx 默认单线程处理请求，但跨请求共享数据时需加锁。

实战案例：用 FastCGI 实现用户登录

最后，我们把 FastCGI 和 Nginx 结合起来，写一个完整的用户登录功能。这涉及到 POST 数据的读取、表单解析以及简单的验证逻辑。

#include <fcgi_stdio.h>
#include <stdlib.h>
#include <string.h>

void decode_url(char *src, char *dst) {
    int i = 0, j = 0;
    while (src[i]) {
        if (src[i] == '%') {
            int value;
            sscanf(src + i + 1, "%2x", &value);
            dst[j++] = (char)value;
            i += 3;
        } else if (src[i] == '+') {
            dst[j++] = ' ';
            i++;
        } else {
            dst[j++] = src[i++];
        }
    }
    dst[j] = '\0';
}

int main() {
    while (FCGI_Accept() >= 0) {
        char *content_type = getenv("CONTENT_TYPE");
        char *request_method = getenv("REQUEST_METHOD");

        if (strcmp(request_method, "POST") == 0) {
            char *content_length_str = getenv("CONTENT_LENGTH");
            int content_length = atoi(content_length_str);

            char *post_data = (char *)malloc(content_length + 1);
            if (post_data) {
                fread(post_data, 1, content_length, stdin);
                post_data[content_length] = '\0';

                char *username = NULL;
                char *password = NULL;
                char *token = strtok(post_data, "&");
                while (token) {
                    char *equals = strchr(token, '=');
                    if (equals) {
                        *equals = '\0';
                        char *key = token;
                        char *value = equals + 1;
                        char decoded_key[100], decoded_value[100];
                        decode_url(key, decoded_key);
                        decode_url(value, decoded_value);
                        if (strcmp(decoded_key, "username") == 0) {
                            username = strdup(decoded_value);
                        } else if (strcmp(decoded_key, "password") == 0) {
                            password = strdup(decoded_value);
                        }
                    }
                    token = strtok(NULL, "&");
                }

                printf("Content-Type: text/plain\n\n");
                if (username && password && strcmp(username, "admin") == 0 && strcmp(password, "123456") == 0) {
                    printf("登录成功！");
                } else {
                    printf("用户名或密码错误！");
                }
                free(username);
                free(password);
                free(post_data);
            }
        } else {
            printf("Content-Type: text/html\n\n");
            printf("<html><head><title>登录页面</title></head>");
            printf("<body><h1>用户登录</h1>");
            printf("<form method='post' action='/login'>");
            printf("用户名：<input type='text' name='username'><br>");
            printf("密码：<input type='password' name='password'><br>");
            printf("<input type='submit' value='登录'></form>");
            printf("</body></html>");
        }
    }
    return 0;
}

配合 Nginx 配置，将 /login 路径转发到 FastCGI 进程即可运行。配置示例如下：

server {
    listen 80;
    server_name localhost;
    location /login {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.cgi;
        include fastcgi_params;
    }
}

在实际项目中，务必注意敏感信息（如密码）不要明文传输，且要防范 SQL 注入和 XSS 攻击。C 语言开发虽然灵活，但也意味着你需要自己处理所有安全细节。