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

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

在高性能 Web 服务领域，C 语言依然占据着不可替代的地位。无论是底层的网络协议栈，还是高并发的网关逻辑，C 的内存控制和执行效率都是其他高级语言难以比拟的。今天我们就深入聊聊如何用 C 语言搞定 Web 开发的核心组件：CGI、FastCGI 以及 Nginx 模块。

CGI：基础但受限的接口

CGI（通用网关接口）是 Web 服务器与外部程序通信的标准方式。它的架构非常直观：客户端发起请求，Web 服务器接收后启动一个 CGI 进程处理，处理完毕返回结果给服务器再发给客户端。

虽然实现简单，但 CGI 有个致命弱点：每次请求都 fork 一个新进程。对于高并发场景，这简直是灾难。不过作为理解 Web 交互的基础，它依然是必修课。

下面是一个标准的 CGI Hello World 示例。注意 HTTP 响应头的格式，必须包含 Content-Type 且后面跟两个换行符，否则浏览器无法正确解析。

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

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

实际开发中，我们更需要处理参数。CGI 通过环境变量传递 GET 参数（QUERY_STRING）或 POST 数据。这里要注意 URL 解码，因为参数中的特殊字符会被编码。

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

避坑提示：CGI 程序容易忽略资源泄漏，特别是动态分配的内存和打开的文件句柄。另外，环境变量未设置时直接解引用会导致崩溃，务必先判空。

FastCGI：性能优化的关键

为了解决 CGI 频繁创建进程的开销，FastCGI 应运而生。它让后端进程保持驻留，通过 socket 或文件描述符复用连接。这意味着一次启动可以处理成千上万个请求，性能提升显著。

FastCGI 的开发流程与 CGI 类似，核心区别在于使用 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;
}

获取参数的逻辑基本一致，只是放在循环内部。这样同一个进程实例就能持续响应不同用户的请求。

Nginx 模块开发：深度集成

如果你需要极致的性能控制，或者想扩展 Nginx 的功能，编写 C 语言模块是最佳选择。Nginx 采用事件驱动模型，配合内存池管理，对并发支持极佳。

开发 Nginx 模块需要熟悉其内部数据结构，比如 ngx_http_request_t 和 ngx_buf_t。下面是一个简单的 Hello World 模块示例，展示了如何注册 Handler 并发送响应。

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

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

注意：Nginx 模块开发对内存管理要求极高，务必使用 Nginx 提供的内存池函数（如 ngx_palloc），避免直接使用 malloc/free，否则可能导致内存泄漏或崩溃。

实战案例：用户登录系统

结合 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;
    }
}

总结

从 CGI 到 FastCGI，再到 Nginx 模块，C 语言在 Web 开发中的角色从边缘走向核心。CGI 适合低流量测试，FastCGI 支撑生产环境，而 Nginx 模块则提供了底层定制能力。掌握这些技术，不仅能写出高性能的服务端代码，更能深入理解 Web 服务器的运作机制。建议读者尝试动手编写一个时间显示服务，或者实现简单的 Cookie 读写，在实践中巩固知识。