指令阿帕奇 HTTP 服务器参考手册

原始文件manual p s gz

文件叙述阿帕奇HTT P服务器参考手册

文件编号 LRG LDTP GUIDE 002

翻译日期 1996/09/01

翻译维护 as dchen@ms 1 hinet net

简体中文版维护:dfbb,fangh@bepc3 ihep ac cn

APACHE

An HTTP Server

Referenc e M anual

@David Robinson and the Ap ache Group, 1995http://www ap ache org/

保留所有权利。这个产品或文件受版权保护并且得在限制其用途复制散播以及编辑的授权下散播。细节请参阅阿帕奇授权书。

版权所有者不对这份手册的内容作任何保证及建议而且特别声明不保证符合任何商业目的。

版权所有者保留修订这份手册的权利且其内容得依时变更而不必通知任何人这些修订与变更。

All rights reserved This product or documentation protected bycopyright and is distributed under licences restricting itsuse,copying,distribution and decomp ilation See the Ap ache licencefor details

The copyright owner gives no warranties and makes no representationsabout the contents of this manual and sp ecifically disclaimswarranties of merchantability of fitness for any purp ose

The Copyright owner reserves the right to revise this manual andmake changes from time to time in its contents without notifying anyp erson of such revision or changes

TRADEMARKS

Unix is a registered trademark of UNIX Sy stem Laboratories, Inc

Sun and SunOs are trademarks of Sun M icrosystems, Inc Netscap e is atrademark of Netscape Communications Corporation All other productnames mentioned h erein are trademarks of their resp ective owners

目录(Cont ent s) 略

序(Preface)

这份手册是10版阿帕奇服务器(Ap ache HTTP s erver)的文件。这个服务器是阿帕奇计划的产品此计划试图回应某些对积极发展一套可以免费取得之HTT P服务器的关心。这个计划的目标是提供一个安全的有效率的而且可以扩充功能的服务器此服务器提供HTT P服务且符合目前的HTT P标准。

这套阿帕奇httpd服务器的设计不但与NCSA httpd 1 3相容并且提供常常有人要求的特色像是

。作为身分验认之用的DBM 资料库

。 自定的(customis ed)错误与问题回应方式

。多重的directory index指令

。不限次数的Alias 以及Redire ct指令

。 以内容为基础的(Content-based)文件协商(negotiation)

。虚拟服务器

阿帕奇授权书

Copyright 1995 The Ap ache Group All rights reserved

假若符合下列条件无论是否经过修改 以原始程序及执行程序的形式散播与使用都是许可的:

1 散播原始程序码必须保留上述的版权告示这份条件列表以及下列

声明。

2 以执行程序码的形式散播必须在随附散播的文件以及或是资讯中

重现上述的版权告示这份条件列表以及下列声明。

3 所有提及或使用这套软体特色的广告都必须显示下列讯息:

`This product includes software develop ed by the Ap ache Groupfor use in the Ap ache HTTP server p roject (http://www ap ache org/) '

4 `Ap ache Server'以及`Ap ache Group'这些名称没有随附前述的

的许可不得用来为这套软体的衍生产品背书或鼓励采用。

5 以任何形式散播都必须保留下列讯息:

`This product includes software develop ed by the Ap ache Groupfor use in the Ap ache HTTP server p roject (http://www ap ache org/) '

Redistribution and use in source and binary forms,with or withoutmodification,are p ermitted provided that the following condictionsare met:

1 Redistribution of source code must retain the above copyrightnotice, this list of condictions and the following disclaimer

2 Redistribution in binary form must reproduce the above copyrightnotice, this list of condictions and the following disclaimer inthe documentation and/or other materials provided with thedistribution

3 All advertising materials mentioning features or use of thissoftware must display the following acknowledge: `This productincludes software developed by the Apache Group for use in the

Ap ache HTTP server p roject (http://www ap ache org/) '

4 The names `Ap ache Server'and`Ap ache Group'must not be used toendorse or prompt products derived from this software withoutp rior writt en p ermis s ion

5 Redistribution of any form whatsoever must retain the followingacknowledge: `This product includes software developed by the

Apache Group for use in the Apache HTTP server project

(http://www ap ache org/) '

THIS SOFTWARE IS PROVIDED BY THEAPACHE GROUP` `AS IS''AND ANYEXPRESSED OR IMPLIED WARRANTIES, INCLUDING,BUT NOT LIM ITED TO,THEIMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FORA PARITICULAR

PURPOSEARE DISCLAIMED IN NO EVENT SHALL THEAPACHE GROUP OR ITSCONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDETAL,SPECIAL,EXEMPLARY OR CONSEQUENTIAL DAMAGES(INCLUDING,BUT NOT LIMITED TO,PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE,DATA ORPROFITS; OR BUSINESS INTERRUPTION)HOWEVER CAUSED AND ON ANYTHEORY

OF LIABILITY,WHERHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHER WISE)ARISING IN ANY WAY OUT OF THE USEOF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE

This software consists of voluntary contributions made by manyindividuals on behalf of the Ap ache Group and was originallybased on public domain software written at the National Centerfor Sup ercomputingApp lications,University of Illinois,Urbana-

Champaign For more information on the apache Group and the Apache

HTTP server p roject,p lease see http://www ap ache org/

第一章

编译以及安装阿帕奇

1 1 下载阿帕奇

最新的阿帕奇资讯可以在阿帕奇网站http://www ap ache org/找到。

此处会列出目前发行的版本任何更新的公开测试版 同时还有映射的

(mirror)网站与匿名文件传输(ftp)站之细节。

12 编译阿帕奇

这一版的阿帕奇支援所谓的‘选用性模组’ 。然而为了使这些模组能

有效率此服务器必须知道哪些模组要编译进去这需要产生一点短短

的程序码(`modules c')单纯地列出它们。

如果你满意我们的标准模组集而且打算继续让它保持这样那麽你可

以直接编辑我们提供的M akefile并且如同你以前作过的一样编译它。

如果你想要使用选用性模组那麽无论如何你都得执行配置指令稿。

这样做:

1 编辑`Configur ation'这个文件。这里面包含每一种机器

的M akefile设定而且在这底下还有个额外的节区列出要

编译进去的模组 以及包含这些模组的文件名称你将得:

(a)选择适合你机器的一种编译器以及编译选项。

(b)消掉相对於你想包含进去的模组上面的注解文件底

端列出模组的那些行或者加上对应你自己所撰写之

自制(custom)模组的一些新行。注意如果你想要有

D BM验认(aut h)的话必须明确地配置进去只要消掉

对应的行上面的注解即可。

2 执行`Configur e'这个指令shell;

%Configur e

Using`Configuration'as config file

%

这会产生新版的M akefile以及modules c文件。如果你

想要维护多个配置那麽你可以这样例如

%Configure-file Configuration ai

Using alternate config file Configuration ai

%

3 键入`make'

我们放进阿帕奇发行套件里的模组是我们测试过而且有许多

阿帕奇发展群成员使用的模组。这些成员或协力团体(thirdp arties)配合特殊需要或功能而贡献的一些额外模组可以在

里

找到。在该网页上有如何连结这些模组到阿帕奇核心程序码

里去的说明。

1 3 安装阿帕奇

编译之後你将会在src/ 目录里获得一份称为`http d' 的可执行文件。阿帕奇的可执行文件发行套件会提供这个文件。

下一个步骤是为服务器编辑配置档。你应该会在称为`conf'的目录里发现三个配置档的发行版本: srm conf-dist,access conf-dist以及http d conf-dist 。把它们复制成所需的srm conf,access conf及http d conf文件。

首先编辑http d conf 。这设定此服务器一般的属性端口号执行者的身分等等。接下来编辑srm conf文件这设定文件树的根目录指定像是

服务端剖析的H TM L或内部的影像地图(imagem ap)剖析等等功能。最後编辑access conf文件至少作些存取(access)的基本设定。

最後调用http d程序使用-f参数配合httpd conf所在的完整路径。像是最普遍的例子:

/usr/local/etc/ap ache/src/http d-f

/usr/local/etc/ap ache/conf/http d conf

现在服务器应该已经开始执行。

依照预设srm conf以及access conf这些文件是藉由名称定位的要藉由其它的名称来指定调用它们的话可以在http d conf里面使用AccessConfig 以及ResourceConfig指令。

第二章

启动阿帕奇

21 启动阿帕奇http d这支程序可以藉由网际网路服务程序inetd在每一次有连线要进入HTT P服务的时候启动或者另一种方式它也可以作为服务程序(d aemo n)持续地执行处理请求。无论选择哪一种方式都必须设定这个ServerTy p e指令告诉服务器它要如何执行。

22 命令列选项

下列选项可以用在http d 的命令列上:

-d serverroot

把Serv erRo o t这个参数的起始值设定为s erv erro o t 。这可以

藉由在配置文件里面的S erv erRo o t命令来加以改变。此预设为

/usr/local/etc/http d 。

-f config

启动时执行在config文件里面的指令。如果config没有以/

作为开始的话那麽它会被当作相对於S erv erRo o t的路径。此

预设值是conf/http d conf 。

-X

以单一程序(single-process)模式执行只用在内部除错服务

程序不会脱离终端作业或是产生任何子程序。不要使用这个模式

来提供正常的网页服务。

-v

列印http d 的版本然後结束。

-?

列印http d选项的一份列表然後结束。

23 配置档

此服务器将会读取三个配置指令文件。任何指令都可以出现在这些文件任何一个里面。这些文件的名称是相对於服务器的根目录(server root) 这是根是藉由Serv erRo o t指令或是-d这个命令列旗标所指定的。依惯例这些文件是:conf/http d conf

包含控制服务程序运作的指令。文件名称可以配合-f命令列旗

旗标加以改变。conf/srm conf

包含控制服务器提供给客户端之文件规格的指令。文件名称可以

配合ResourceConfig指令加以改变。conf/access conf

包含控制文件之存取的指令。文件名称可以配合AccessConfig

指令加以改变。

无论如何这些惯例并不需要完全遵奉。

此服务器也会读取一个包含MIME文件型态的文件这个文件名称藉由Typ esConfig指令设定而且有个conf/mini typ es作为预设。

24 记录档

241 pid档

服务程序启动时它把父程序httpd 的程序码(process id)存往这个log/http d p id文件。这个文件名称可以配合PidFile指令加以改变

。这个程序码由管理者用来重新启动或终止服务程序一个HUP信号会使服务程序重新读取其配置档而一个T ERM信号会使它终止。如果程序不正常地死掉或被杀掉那麽必须杀掉http d子程序。242 错误记录

服务器会将错误讯息记录到一个记录档去预设为log/error_lo g 。文件名称可以藉由ErrorLo g指令设定可以为不同的虚拟主机设定不同的错误记录。

243 传输记录

服务器一般会将每个请求记录到一个传输档预设为logs/acc es s_log。文件名称可以藉由T rans ferLog指令设定可以为不同的虚拟主机设定不同的传输记录。

第三章

阿帕奇核心部份(core)的特色

这些配置参数控制核心部份的阿帕奇特色而且是固定可以使用的。3 1 AccessConfig指令

语法:AccessConfig文件名称

预设:AccessConfig conf/access conf

用於: server config,virtual host

状态:核心

此服务器读取ResourceConfig文件之後将会继续读取这个文件以取得更多指令。文件名称系相对於S erv erRo o t路径。此特色可以使用如下的方式关闭:

Acces sConfig/dev/nu ll

原本这个文件只包含 节区事实上它现在可以包含任何

可以用於服务器配置的指令。

32 AccessFileName指令

语法:AccessFileName文件名称

预设:AccessFileName htaccess

用於: server config,virtual host

状态:核心

回传文件给客户端的时候如果目录的存取控制档有启动服务器会在到达这份文件的路径中的每个目录里以此名称搜寻存取控制档。例如:AccessFileName acl

在回传/usr/local/web/index html这份文件前此服务器将会读取/acl, /usr/ac l, /usr/lo cal/ac l以及/usr/lo cal/web/acl 以

取得指令除非以如下的方式关闭它们:

AllowOverride None

33 AllowOverride指令

语法:AllowOverride ov erride ov erride

预设:AllowOverride All

用於:directory

状态:核心

服务器找到AccessFileName指定的文件时会需要知道该文件所宣告的哪些指令可以改变稍早的存取资讯。

Override可以设为None在此情况下服务器将不会读取该档而设为All的话服务器将会允许所有的指令或是下列其中之一:

AuthConfig

允许验认指令的使用(AuthD BM Group F ile, AuthD BM Us erF ile,AuthGroupF ile, AuthName, AuthTyp e, AuthUs erF ile andrequire)

F ileInfo

允许控制文件型态之指令的使用(AddEncodin g, AddLan guage,AddTyp e,D efaultTyp e and Langu agePriority)