CGI(公共网关接口[Common Gateway Interface])定义了网站服务器与外部内容协商程序之间交互的方法，通常是指CGI程序或者CGI脚本，是在网站上实现动态页面的最简单而常用的 方法。本文将对如何在Apache网站服务器上建立CGI以及如何编写CGI程序作介绍。

配置Apache以允许CGI

要让CGI程序能正常运作，必须配置Apache以允许CGI的执行，其方法有多种。

ScriptAlias

ScriptAlias指令使Apache允许执行一个特定目录中的CGI程序。当客户端请求此特定目录中的资源时，Apache假定其中文件都是CGI程序并试图运行。

ScriptAlias指令形如：

ScriptAlias /cgi-bin/ /usr/local/apache/cgi-bin/

如果Apache被安装到默认的位置，默认的配置文件httpd.conf中则会有上述配置。ScriptAlias指令定义了映射到一个特定目录的URL前缀，与Alias指令非常相似，两者一般都用于指定位于DocumentRoot目录以外的目录，其区别是ScriptAlias又多了一层含义，即其URL前缀中任何文件都被视为CGI程序。所以，上述例子会指示Apache，/cgi-bin/应该指向/usr/local/apache/cgi-bin/目录，且视之为CGI程序。

举例，如果有URL为http://www.example.com/cgi-bin/test.pl的请求，Apache会试图执行/usr/local/apache/cgi-bin/test.pl文件并返回其输出。当然，这个文件必须存在而且可执行，并以特定的方法产生输出，否则Apache返回一个出错消息。

ScriptAlias目录以外的CGI

由于安全原因，CGI程序通常被限制在ScriptAlias指定的目录中，如此，管理员就可以严格地控制谁可以使用CGI程序。但是，如果采取了恰当的安全方法措施，则没有理由不允许其他目录中的CGI程序运行。比如，你可能希望用户在UserDir指定的宿主目录中存放页面，而他们有自己的CGI程序，但无权存取cgi-bin目录，这样，就产生了运行其他目录中CGI程序的需求。

用Options显式地允许CGI的执行

可以在主服务器配置文件中，使用Options指令显式地允许特定目录中CGI的执行：

Options +ExecCGI

上述指令使Apache允许CGI文件的执行。另外，还必须告诉服务器哪些文件是CGI文件。下面的AddHandler指令告诉服务器所有带有cgi或pl后缀的文件是CGI程序：

AddHandler cgi-script .cgi .pl

编写CGI程序

编写CGI程序和``常规''程序之间有两个主要的不同。

首先，在CGI程序的所有输出前面必须有一个MIME类型的头，即HTTP头，对浏览器指明所接收内容的类型，大多数情况下，形如：

Content-type: text/html

其次，输出要求是HTML形式的，或者是浏览器可以显示的其他某种形式。多数情况下，输出是HTML形式的，但偶然也会编写CGI程序以输出一个gif图片或者其他非HTML的内容。

除了这两点，编写CGI程序和编写其他程序大致相同。

第一个CGI程序

这个CGI程序例子在浏览器中打印一行文字。把下列存为first.pl文件，并放在你的cgi-bin目录中。

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

即使不熟悉Perl语言，你也应该能看出它干了什么。第一行，告诉Apache这个文件可以用/usr/bin/perl(或者任何你正在使用的shell)解释并执行。(注意对于windows环境下：1下载Windows下的Perl解释器ActivePerl,官方网站:http://www.activestate.com/。我的perl安装路径为：E:/program/devel/perl/bin/perl.exe ，所以要改为此路径，否则apache不能找到此程序解释程序，报500错误。)

第二行，打印上述要求的内容类型说明，并带有两个换行，在头后面留出空行，以示HTTP头的结束。第三行，打印文字``Hello, World.''。程序到此结束。

打开你喜欢的浏览器并输入地址：

http://www.example.com/cgi-bin/first.pl

或者是你存放程序的其他位置，就可以在浏览器窗口中看到一行Hello, World.。虽然并不怎么激动人心，但是一旦这个程序能正常运作，那么就可能运作其他任何程序。

在apache/cgi-bin/目录里有一些测试例子，我们可能用它来测试下，看看配置是否能正常运行。
比如说apache/cgi-bin/目录下有个test-cgi程序，源码如下：

#!/bin/sh

# disable filename globbing

set -f

echo "Content-type: text/plain; charset=iso-8859-1"

echo

echo CGI/1.0 test script report:

echo

echo argc is $#. argv is "$*".

echo

echo SERVER_SOFTWARE = $SERVER_SOFTWARE

echo SERVER_NAME = $SERVER_NAME

echo GATEWAY_INTERFACE = $GATEWAY_INTERFACE

echo SERVER_PROTOCOL = $SERVER_PROTOCOL

echo SERVER_PORT = $SERVER_PORT

echo REQUEST_METHOD = $REQUEST_METHOD

echo HTTP_ACCEPT = "$HTTP_ACCEPT"

echo PATH_INFO = "$PATH_INFO"

echo PATH_TRANSLATED = "$PATH_TRANSLATED"

echo SCRIPT_NAME = "$SCRIPT_NAME"

echo QUERY_STRING = "$QUERY_STRING"

echo REMOTE_HOST = $REMOTE_HOST

echo REMOTE_ADDR = $REMOTE_ADDR

echo REMOTE_USER = $REMOTE_USER

echo AUTH_TYPE = $AUTH_TYPE

echo CONTENT_TYPE = $CONTENT_TYPE

echo CONTENT_LENGTH = $CONTENT_LENGTH

然后在浏览器里输入http://127.0.0.1/cgi-bin/test-cgi
如果设置正确就能显示如下信息

CGI/1.0 test script report:

argc is 0. argv is .

SERVER_SOFTWARE = Apache/2.2.10 (Unix) PHP/5.2.8

SERVER_NAME = 127.0.0.1

GATEWAY_INTERFACE = CGI/1.1

SERVER_PROTOCOL = HTTP/1.1

SERVER_PORT = 50001

REQUEST_METHOD = GET

HTTP_ACCEPT = text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8

PATH_INFO =

PATH_TRANSLATED =

SCRIPT_NAME = /cgi-bin/test-cgi

QUERY_STRING =

REMOTE_HOST =

REMOTE_ADDR = 127.0.0.1

REMOTE_USER =

AUTH_TYPE =

CONTENT_TYPE =

CONTENT_LENGTH =

当然你也可以选择用其它语言来写一个cgi程序，其中apache提供了一个用pear写的例子。
下面是用Ｃ语言写的一个简单的例子。

#include

#include

int main (int argc, char** argv) {

char a[] = "-100";

char b[] = "456";

int c;

c = atoi(a) + atoi(b);

char *p;

p = getenv("QUERY_STRING");

printf("Content-type: text/html/n/n");

printf("c=%d",c);

printf("%s",p);

return 0;

}

 

实现功能为：打印打印a+b的值，如果有get参数，同时打印get参数