Apache HTTP Server CGI 动态内容开发指南

Apache HTTP Server CGI 动态内容开发指南

什么是 CGI

CGI（Common Gateway Interface，通用网关接口）是 Web 服务器与外部程序之间交互的标准协议。它允许 Web 服务器将用户请求传递给特定的程序处理，并将处理结果返回给用户浏览器。通过 CGI，开发者可以使用各种编程语言（如 Perl、Python、PHP 等）创建动态网页内容。

配置 Apache 支持 CGI

1. 加载 CGI 模块

首先确保 Apache 已加载 CGI 模块。在 httpd.conf 配置文件中检查以下内容：

对于 Windows 或非线程 MPM（如 prefork）：

LoadModule cgi_module modules/mod_cgi.so

对于线程化 MPM（如 worker 或 event）：

LoadModule cgid_module modules/mod_cgid.so

2. 使用 ScriptAlias 指定 CGI 目录

最简单的方法是使用 ScriptAlias 指令指定一个专门存放 CGI 程序的目录：

ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"

这样，所有访问 /cgi-bin/ 路径的请求都会映射到 /usr/local/apache2/cgi-bin/ 目录，且该目录下的文件都会被当作 CGI 程序执行。

3. 在非 ScriptAlias 目录启用 CGI

如需在其他目录启用 CGI，需要：

1. 使用 AddHandler 或 SetHandler 指令设置 CGI 处理器
2. 在 Options 指令中启用 ExecCGI

示例配置：

<Directory "/usr/local/apache2/htdocs/somedir">
    Options +ExecCGI
    AddHandler cgi-script .cgi .pl
</Directory>

4. 用户目录中的 CGI

允许用户在个人目录中运行 CGI 程序：

<Directory "/home/*/public_html">
    Options +ExecCGI
    AddHandler cgi-script .cgi
</Directory>

或者为每个用户创建专门的 cgi-bin 目录：

<Directory "/home/*/public_html/cgi-bin">
    Options ExecCGI
    SetHandler cgi-script
</Directory>

编写 CGI 程序

CGI 程序的基本要求

1. 输出 MIME 类型头：必须在所有输出前指定内容类型
2. 生成有效输出：通常是 HTML，也可以是其他格式（如图片）

第一个 CGI 程序示例（Perl）

#!/usr/bin/perl
print "Content-type: text/html\n\n";
print "Hello, World.";

这个简单程序：

1. 第一行指定 Perl 解释器路径
2. 第二行输出 HTTP 头，包含内容类型和两个换行（表示头结束）
3. 第三行输出实际内容

保存为 first.pl 并放入 CGI 目录后，通过浏览器访问即可看到输出。

常见问题排查

1. 看到程序源代码或"POST Method Not Allowed"

说明 Apache 未正确配置 CGI 支持，请检查：

• 是否正确加载了 CGI 模块
• 是否配置了 ScriptAlias 或正确设置了 ExecCGI
• 文件扩展名是否正确关联到 CGI 处理器

2. "Forbidden" 错误

通常是权限问题：

• 确保 CGI 程序有执行权限：chmod a+x program.cgi
• 检查程序访问的其他文件是否有适当权限

3. "Internal Server Error"

查看 Apache 错误日志，常见原因：

• 程序语法错误
• 缺少 MIME 类型头
• 解释器路径错误（#!/usr/bin/perl）

路径问题

CGI 程序运行时环境可能与命令行不同：

• 使用绝对路径调用外部程序
• 确保解释器路径正确
• 必要时设置 PATH 环境变量

CGI 工作原理

当浏览器请求 CGI 程序时：

1. Apache 收到请求
2. 根据配置识别为 CGI 程序
3. 启动 CGI 程序（创建新进程）
4. 将请求信息通过环境变量传递给 CGI 程序
5. 捕获程序输出并返回给客户端

安全注意事项

1. 限制 CGI 目录访问
2. 对用户输入进行严格验证
3. 避免使用系统调用处理用户输入
4. 定期更新 CGI 程序和相关库

进阶建议

1. 性能考虑：CGI 每次请求都会创建新进程，高流量站点考虑使用 FastCGI 或 mod_perl
2. 错误处理：在 CGI 程序中实现完善的错误捕获和日志记录
3. 会话管理：通过 cookie 或隐藏字段实现用户会话跟踪

通过合理配置和编写 CGI 程序，您可以在 Apache 服务器上实现各种动态内容功能，从简单的表单处理到复杂的 Web 应用程序。