linux Apache CGI 安装配置

本文假定你已经安装好linux(本文的linux版本为fedora core3), 并具有root权限.
1,安装apache
首先到apache的主页下载最新版本的apache http server,地址为 http://httpd.apache.org/
本文写于2006.4.29,apache版本为2.2.0 .如果你也想用这一个版本的话请点击:http://mirror.vmmatrix.net/apache/httpd/httpd-2.2.0.tar.gz
安装apache:
切换到httpd-2.2.0.tar.gz所在目录,然后:
# tar xvzf httpd-2.2.0.tar.gz
此时在该目录下有一个文件夹 httpd-2.2.0,切换到该文件夹:
# cd ./httpd-2.2.0
我不知道你想把apache安装到哪个文件夹,我们假定想安装到 /usr/local/apache2/ 下面,则
输入下面的命令:
# ./configure --prefix= /usr/local/apache2
# make
# make install
执行完这3条命令之后,apache就安装到你的 /usr/local/apache2目录下了.
切换到该目录看看有什么咚咚吧;)
# cd ./usr/local/apache2
# ls
可以看到里面有 /bin ,/conf , /htdocs, /cgi-bin 等目录.此时apache还没有启动,我们通过/bin目录下的工具apachectl来启动,首先切换到/bin目录:
# cd ./bin
然后启动:
# ./apachectl start
这时候在地址栏输入 http://localhost/ 看看是不是有成功的信息?(笔者看到的是 "it works!") 的信息, 当然不同的版本会不同,根据你 /htdocs 下的index.html内容而定.
把/usr/local/apache2/htdocs/index.html 替换成你的页面文件就可以了.
到了这里,我们假定你的apache服务器已经安装成功.如果还有问题请在网上搜索一下或者联系我:
lonestep at gmail d。t com
2, 配置apache使之执行cgi程序
默认下,cgi程序必须放在cgi-bin目录下,我们先来配置使得cgi-bin下的cgi程序能得到正确执行,
后面将会介绍怎么让apache执行放在别的目录下的cgi程序.
1),承上,我们已经把apache安装到 /usr/local/apache2 目录下,切换到/usr/local/apache2/conf 目录,里面有一个 httpd.conf 文件, 编辑这个文件:
# cd /usr/local/apache2/conf
# vi httpd.conf (假定你的文本编辑器是vi, 如果你用别的编辑器如emacs, gedit, kedit 之类,把vi 替换成它们的命令即可)
寻找其中一行如:
# scriptalias /cgi-bin/ "/usr/local/apache2/cgi-bin/"
把这行前面前面的'#'去掉,然后重新启动apache :
# cd ./bin (or cd /usr/local/apache2/bin)
# ./apachectl restart
ok, 假如你放了一个cgi程序'test.cgi'到cgi-bin的话,在地址栏
输入 http://localhost/cgi-bin/test.cgi 看看是否能够执行>?
如果不能,请发邮件给我:)
2),如果你想改变执行cgi的目录(不用默认的cgi-bin目录),则该变刚才的
scriptalias /cgi-bin/ "/usr/local/apache2/cgi-bin/" 为:
scriptalias /someotherdirectory/ "/usr/local/apache2/cgi-bin/"
然后重新启动apache.
以上的过程都是比较简单的,如果您遇到了本文未曾涉及的问题,或者与本文假设不同的条件,
请先到internet上查找解决办法,如果还不行(once and once again)可以发邮件给我:)
一. cgi 的配置过程

1.cgi执行目录设置. 一般在 /usr/local/apache/cgi-bin/文件夹中. 在httpd.conf配置文件中能找到相关信息. 例如我把的cgi 程序是test.pl 那么地应的http请法地址就是:http://localhost/cgi-bin/test.pl

2.cgi 的执行目录出于全安考虑一般只给读权限.对应的httpd.conf 中的配置可执行cgi的地方如下:

<directory /usr/local/apache/htdocs/somedir>
options +execcgi
</directory>

3.htaccess文件
阿.htaccess文件是一种方法，一套配置指令对每个目录的基础。 当apache服务的资源，它看起来在目录中由它提供的文件的文件要求.htaccess ，如果它认为有，它将适用于指示发现的。 .htaccess文件可以被允许的allowoverride指令，其中具体规定哪些类型的指令可以出现在这些文件，或者，如果他们也不允许的。 允许指令，我们将需要为此目的，下面的配置将需要在您的主服务器配置.


二, 配置文件的内容和参数意思


在配置目录中有三个文件，分别是：
1. conf/httpd.conf ：
servertype ：有两个值可供选择standalone 和inetd
standalone ： 表示你的httpd进程，是以一个单独的守护进程（daemon）的方式 在后台侦听是否有客户端的请求。
inetd ：表示你的httpd进程不是以守护进程（daemon）的方式运行，而是由inetd 这个 internet services的进程侦听，一旦有客户的请求，他会自动的启动httpd这个进程来提供相应的服务 默认的是standalone方式，如果你不是对 arpa berkeley services 不是很了解的 话，不要更改。
port ： 你分配给你的web server 的端口号。
httpd 的默认端口是80，也可以分配给自己的web server 一个大于1024 的
端口号。如果你这样作，你必须在你的url后面跟上你的端口号才能访问到你
的页面。比如你分配给你的服务的端口号是8888，那么你访问时需要输入
http://domainname:8888
serveradmin ：服务管理员的email 地址，默认的是本机的root用户，所以是
root@localhost
serverroot ：用来存放服务的配置、出错和记录文件的目录。
bindaddress ：虚拟主机的ip地址。用一台机子虚拟多台机子。
errorlog ：用来存放你web server的出错信息的文件。
transferlog ：用来存放记传输过的文件名的记录文件。
pidfile ：该指定的文件存放了httpd进程的进程号，用来停止web server。
scoreboardfile ：用来存放进程的信息。
servername ：你机子的名称，如果你有域名，填入你本机的域名。如果没有，就
填入你的主机名或ip地址。
timeout ：传输或接收的延时。大于这个时间server 会断开这个链接。
keepalive ：(on or off)是否允许一个链接同时发出多的请求。
keepalivetimeout ：（default is 15）等待下一个请求的时间。
maxclients ：（default is 150）允许的最大客户个数。
通常上面的参数的默认值是不用改的，但是如果你同时在一台机子上开几个web server 时要注意。第一，你要给每一个web server 分配不同的port 号。第二，要分别指定他们的errorlog文件和pidfile文件。第三，不懂的参数不要随意改动，即使改动也要一次改一个，并留有记录以便恢复。


2. /conf/access.conf :
主要是对目录的功能和访问的控制的设定。下面我针对默认的页面的配置文件进行说明。该文件的位置是：/etc/httpd/conf/access.conf.
该文件的第一段非注释部分如下：
<directory /home>
options indexes includesnoexec
allowoverride none
</directory>
大家注意到这一部分是以<directory /home>开头，以</directory>结束的。其中开头的部分<directory /home>表示下面的设定是针对 /home 目录的。options 这一命令有很多的参数，各参数的功能如下：
all 所有的选项除了multiviews功能。
execcgi 开启执行cgi程序的功能。
followsymlinks 开启一个动态的链接，当有客户访问到该目录时会自动
的链接到另一个相关的目录中去。
includes 开启服务端的引用功能。
includesnoexec 开启服务端的引用功能，但是#exec和cgi程序的引用将
被禁止。
indexes 如果没有index.html文件在目录中，就会显示文件列表。
symlinksifownermatch 只有在链接的目标文件或目录与当前的目录属于同一用
户时，才开启链接。
接着是allowoverride参数，该参数是设定访问控制的。这里把他设置成none，表示没有开启该功能。
第二部分是：
<directory /home/httpd/html>
options indexes includes execcgi followsymlink
allowoverride none
order allow,deny
allow from all
</directory>
第三部分是：
<directory /home/httpd/cgi-bin>
allowoverride none
options execcgi
</directory>
表示对/home/httpd/cgi-bin 不进行访问控制，允许执行cgi程序。这就表明这是一个用来存放cgi程序的目录

3. /conf/srm.conf
主要是用来指定你的文档的位置。
第一个参数是：documentroot 。用来指定主文档的地址。
第二个参数是：userdir 。用来指定个人主页的位置。如果你有一个用户的home目录为 /home/jon 当在url中输入 http://yourdomain/~jon 系统就会到 /home/jon/x/中去取这个用户的个人主页。其中x为userdir 所指定的目录。
第三个参数是：directoryindex。用来声明查找的索引文件的名称。
其他的不改也无防。通常用到的就是上面的几个选项。

具体示例
需要建立一个开机启动的web server。假定你的文档目录为/home/jon/html。
首先，更改/etc/httpd/conf/access.conf文件的内容。将原文档的目录更改为新的文档目录。
例如如下的更改：

<directory /home/httpd/html> ? <directory /home/jon/html>
options indexes includes execcgi followsymlink
allowoverride none
order allow,deny
allow from all
</directory>
<directory /home/httpd/cgi-bin> ? <directory /home/jon/cgi-bin>
allowoverride none
options execcgi
</directory>

如上做相应的更改，注意 /home/jon/cgi-bin为你的cgi程序的目录。
接着，修改 /etc/httpd/conf/srm.conf文件。
将documentroot /home/httpd/html 改为documentroot /home/jon/html
最后，修改 /etc/httpd/conf/httpd.conf文件。
将servername 这一个参数后面的原来的内容替换为你的本机ip地址或主机名，同时去掉前面的注释符 “#”。这里的配置为：
servername jon (jon 为我的主机名)
从新启动httpd进程：
＃/etc/rc.d/init.d/httpd restart

四. cgi 程序的编写

首先，所有输出从您的cgi程序之前，必须由一个mime类型的标题
1. 首先要确定content-type: text/html