C語言 CGI 開發實戰：Apache 配置與首個 CGI 程序構建

C語言 CGI 開發實戰：Apache 配置與首個 CGI 程序構建

雖然現代 Web 開發多用高級語言框架，但 C 語言 CGI 以極致性能、超低內存佔用、直接調用系統庫的優勢，在嵌入式 Web 界面、高頻交易網關、舊系統改造等場景仍不可替代。本文從 Apache 安裝配置到首個 CGI 程序編寫，提供完整落地指南。

環境準備：Apache HTTP Server 安裝與配置

1. 安裝 Apache（Windows 示例）

1. 下載 httpd-2.4.x-win64-VC15.zip 解壓至 C:\Apache24
2. 以管理員身份運行 httpd.exe -k install 安裝服務
3. 啟動服務：httpd.exe -k start 或服務管理器中啟動 Apache2.4
4. 驗證：瀏覽器訪問 https://localhost 見到 "It works!"

2. 關鍵配置修改 conf/httpd.conf

# 1. 載入 CGI 模塊（取消註釋）
LoadModule cgid_module modules/mod_cgid.so

# 2. 配置 CGI 腳本目錄
ScriptAlias /cgi-bin/ "C:/Apache24/cgi-bin/"

<Directory "C:/Apache24/cgi-bin">
    AllowOverride None
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    Require all granted
    
    # 3. 關鍵：指定 .cgi/.exe 為可執行腳本
    AddHandler cgi-script .cgi .exe
    
    # 4. 允許 CGI 執行（防止 403 Forbidden）
    Options +ExecCGI
</Directory>

3. 創建 CGI 目錄並設置權限

mkdir C:\Apache24\cgi-bin
# Windows 無需 chmod，確保 IIS_IUSRS / Users 有讀取/執行權限

首個 C 語言 CGI 程序：Hello World

源碼 hello.c

#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main() {
    // 1. 必須輸出 HTTP 頭（Content-Type + 空行）
    printf("Content-Type: text/html; charset=utf-8\r\n\r\n");
    
    // 2. 輸出 HTML 內容
    printf("<!DOCTYPE html>\n");
    printf("<html><head><title>C CGI Demo</title></head><body>\n");
    printf("<h1>Hello from C CGI!</h1>\n");
    printf("<p>Server time: ");
    
    // 3. 示例：調用 C 庫函數獲取時間
    time_t now = time(NULL);
    printf("%s", ctime(&now));
    
    printf("</p></body></html>\n");
    return 0;
}

編譯為可執行文件

# GCC (MinGW)
gcc hello.c -o hello.exe -static

# MSVC (Visual Studio Developer Command Prompt)
cl hello.c /Fehello.exe /MT

關鍵： 輸出文件名為 hello.exe，放入 C:\Apache24\cgi-bin\。

驗證訪問

瀏覽器打開 https://localhost/cgi-bin/hello.exe 應顯示動態生成的 HTML 頁面。

CGI 核心機制深度解析

環境變量傳遞（GET/POST 統一入口）

GET 參數解析示例

char *query = getenv("QUERY_STRING");
if (query) {
    // 簡易解析 name=value&name2=value2
    char *token = strtok(query, "&");
    while (token) {
        char *eq = strchr(token, '=');
        if (eq) {
            *eq = '\0';
            printf("Param: %s = %s
\n", token, eq+1);
        }
        token = strtok(NULL, "&");
    }
}

POST 數據讀取

char *len_str = getenv("CONTENT_LENGTH");
if (len_str) {
    int len = atoi(len_str);
    char *post_data = malloc(len + 1);
    fread(post_data, 1, len, stdin);  // stdin 讀取 POST 體
    post_data[len] = '\0';
    // 同樣解析 name=value 格式
    free(post_data);
}

安全與性能優化清單

1. 輸入驗證：所有環境變量、QUERY_STRING、POST 數據視為不可信，防注入
2. 緩衝區保護：用 fgets/fread 限制長度，禁用 gets/sprintf
3. 最小權限：CGI 進程以專用低權限用戶運行（Linux: suexec，Windows: 應用程序池身份）
4. 超時控制：Apache Timeout / CGIDScriptTimeout 防止掛死
5. FastCGI 升級：高併發場景遷移至 FastCGI（mod_fcgid），避免進程頻繁 fork/exec 開銷

調試技巧

• 日誌輸出：fprintf(stderr, "DEBUG: %s\n", msg); 寫入 Apache error.log
• 命令行直跑：cd cgi-bin && ./hello.exe 檢查語法錯誤、鏈接庫缺失
• 環境變量模擬：REQUEST_METHOD=GET QUERY_STRING="a=1" ./hello.exe

C 語言 CGI 開發看似「古老」，實則是理解 Web 服務器與應用程序交互本質的最佳切入點。掌握 CGI 協議細節，對排查現代框架底層疑難雜症、設計高性能網關、實現語言無關的微服務通信，都有不可替代的啟發價值。

1. 上一篇文章： C語言隨機數生成完全指南：從 rand/srand 到 C++11 標準庫
2. 下一篇文章： C語言速成入門第1課：程序結構、數據類型、輸入輸出與控制流完整講義

關於C語言

資料結構教科書演算法實作：二元搜尋樹（Binary Search Tree）完整原始碼與測試

資料結構教科書演算法實作：二元搜尋樹（Binary Sear

C# 實現螢幕鍵盤 ScreenKeyboard（六）——全域滑鼠鉤子實現無焦點視窗與最終效果

核心需求：不可取得焦點但可拖曳 螢幕鍵盤視窗不可搶奪輸入焦點

C語言星號圖形列印教學（四）：倒置左對齊直角三角形

圖形目標 列印高度 5 行的倒置左對齊直角三角形： ***

用 C# Builder 開發資料庫應用程式（三）：匯出資料到 Excel

透過 COM 元件完成資料匯出 Excel 為了在 C# 中