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

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

一、为什么选择 C 语言做 Web 后端？

尽管现代 Web 开发中 Python、Go 等语言层出不穷，但 C 语言凭借极高的性能和可移植性，在底层网络编程和系统级服务中依然不可替代。理解 CGI、FastCGI 以及 Nginx 模块开发，是掌握高性能 Web 架构的关键一步。

二、CGI：通用网关接口的基础

1. 核心原理

CGI（Common Gateway Interface）是最早的 Web 服务器扩展标准。其工作流程相对简单：Web 服务器接收到请求后，会 fork 一个新的进程来运行 CGI 程序，处理完请求并输出响应后，该进程立即销毁。

这种机制虽然实现简单，但每次请求都涉及进程创建和销毁，开销较大，难以应对高并发场景。

2. 开发要点

编写 CGI 程序时，主要依赖环境变量传递请求信息。下面是一个基础的 Hello World 示例，注意 HTTP 响应头的格式必须严格符合规范。

#include <stdio.h>
#include <stdlib.h>

int main() {
    // 设置 HTTP 响应头，注意有两个换行符
    printf("Content-Type: text/plain\n\n");
    // 输出响应内容
    printf("Hello from CGI!");
    return 0;
}

3. 参数解析与避坑

实际开发中，我们需要处理 GET 或 POST 传来的参数。GET 请求通常通过 QUERY_STRING 环境变量获取，而 POST 则需要读取 stdin。

这里有一个简单的 URL 解码函数，用于处理 %xx 编码和空格转换，这是处理表单数据时的常见需求。

#include <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() {
    // 获取环境变量
    char *query_string = getenv("QUERY_STRING");
    char *request_method = getenv("REQUEST_METHOD");

    printf("Content-Type: text/plain\n\n");
    printf("Query String: %s\n", query_string ? query_string : "");
    printf("Request Method: %s\n", request_method ? request_method : "");

    if (strcmp(request_method, "GET") == 0 && query_string) {
        char *token = strtok(query_string, "&");
        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);
                printf("Parameter: %s = %s\n", decoded_key, decoded_value);
            }
            token = strtok(NULL, "&");
        }
    }
    return 0;
}

注意事项： 务必检查 getenv 返回是否为 NULL，避免空指针解引用；同时要注意资源泄漏问题，特别是在处理长连接或复杂数据结构时。

三、FastCGI：性能优化的关键

1. 架构改进

为了解决 CGI 频繁创建进程的痛点，FastCGI（Fast Common Gateway Interface）应运而生。它允许 CGI 程序保持驻留状态，通过 socket 或管道与 Web 服务器通信，从而复用进程，大幅提升吞吐量。

2. 代码实现

FastCGI 的核心在于使用 fcgi_stdio.h 库中的 FCGI_Accept() 函数。它会阻塞直到有请求到达，处理完后继续循环等待下一个请求。

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

int main() {
    // FCGI_Accept 会持续监听请求
    while (FCGI_Accept() >= 0) {
        printf("Content-Type: text/plain\n\n");
        printf("Hello from FastCGI!");
    }
    return 0;
}

结合之前的参数解析逻辑，我们可以构建一个支持 GET/POST 的 FastCGI 应用。由于进程常驻，内存分配和初始化只需做一次，效率远高于 CGI。

四、Nginx 与 C 语言模块开发

1. Nginx 架构简述

Nginx 采用事件驱动和多进程模型，Master 进程负责管理 Worker 进程，Worker 处理实际请求。这种设计使其能轻松支撑高并发。

2. 编写 Nginx 模块

如果你需要深度定制 Nginx 行为（如鉴权、日志分析），可以直接用 C 语言编写模块。这比配置 rewrite 规则更灵活，但复杂度也更高。

以下是一个最简单的 Nginx HTTP 模块骨架，用于返回固定文本。

#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;
}

// 注意：实际模块定义需包含完整的 ctx 结构体初始化
static ngx_http_module_t ngx_http_hello_module_ctx_full = {
    NULL, ngx_http_hello_init, NULL, NULL, NULL, NULL, NULL, NULL
};

3. 配置示例

编译好模块后，需要在 Nginx 配置文件中指定 FastCGI 转发规则。

server {
    listen 80;
    server_name localhost;

    location /login {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.cgi;
        include fastcgi_params;
    }
}

五、实战案例：用户登录功能

将上述知识结合起来，我们可以实现一个简单的用户登录系统。这里演示一个基于 FastCGI 的完整流程：接收 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>");
            printf("<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='登录'>");
            printf("</form>");
            printf("</body></html>");
        }
    }
    return 0;
}

六、总结

从 CGI 到 FastCGI，再到 Nginx 模块开发，C 语言在 Web 服务端的表现力依然强劲。关键在于理解进程生命周期、内存管理以及协议细节。对于初学者，建议先从 CGI 入手理解请求响应模型，再逐步过渡到 FastCGI 和 Nginx 二次开发。动手实践几个小项目，比如时间查询、Cookie 处理或文件上传，能帮你更好地消化这些概念。