阿帕奇 HTTP 服务器参考手册 - 中国WEB开发者网络 (http://www.webasp.net) -- 技术教程 (http://www.webasp.net/article/) --- 阿帕奇 HTTP 服务器参考手册 (http://www.webasp.net/article/12/11167.htm) |
| -- 作者:未知 -- 发布日期: 2004-06-11 |
|
原始文件:manual.ps.gz APACHE An HTTP Server Reference Manual
@ David Robinson and the Apache Group, 1995 保留所有权利。这个产品或文件受版权保护并且得在限制其用途,复制,散播以及编辑的授权下散播。细节请参阅阿帕奇授权书。 版权所有者不对这份手册的内容作任何保证及建议而且特别声明不保证符合任何商业目的。 版权所有者保留修订这份手册的权利且其内容得依时变更而不必通知任何人这些修订与变更。 All rights reserved. This product or documentation protected by copyright and is distributed under licences restricting its use,copying,distribution and decompilation. See the Apache licence for details. The copyright owner gives no warranties and makes no representations about the contents of this manual and specifically disclaims warranties of merchantability of fitness for any purpose. The Copyright owner reserves the right to revise this manual and make changes from time to time in its contents without notifying any person of such revision or changes.
目录(Contents) (略) 序(Preface)
最新的阿帕奇资讯可以在阿帕奇网站 http://www.apache.org/ 找到。此处会列出目前发行的版本,任何更新的公开测试版,同时还有映射的(mirror)网站与匿名文件传输(ftp) 站之细节。
这一版的阿帕奇支援所谓的‘选用性模组’。然而,为了使这些模组能有效率,此服务器必须知道哪些模组要编译进去;这需要产生一点短短的程序码(`modules.c') 单纯地列出它们。 如果你满意我们的标准模组集,而且打算继续让它保持这样,那麽你可以直接编辑我们提供的 Makefile 并且如同你以前作过的一样编译它。如果你想要使用选用性模组,那麽无论如何,你都得执行配置指令稿。 这样做: 1. 编辑 `Configuration' 这个文件。这里面包含每一种机器的 Makefile 设定,而且在这底下还有个额外的节区列出要编译进去的模组,以及包含这些模组的文件名称,你将得: (a) 选择适合你机器的一种编译器以及编译选项。 2. 执行 `Configure' 这个指令shell; % Configure 这会产生新版的 Makefile 以及 modules.c 文件。如果你想要维护多个配置,那麽你可以这样,例如 % Configure -file Configuration.ai 3. 键入 `make' 我们放进阿帕奇发行套件里的模组是我们测试过而且有许多阿帕奇发展群成员使用的模组。这些成员或协力团体(third parties)配合特殊需要或功能而贡献的一些额外模组可以在 里找到。在该网页上有如何连结这些模组到阿帕奇核心程序码里去的说明。
编译之後,你将会在 src/ 目录里获得一份称为 `httpd' 的可执行文件。阿帕奇的可执行文件发行套件会提供这个文件。 下一个步骤是为服务器编辑配置档。你应该会在称为 `conf' 的目录里发现三个配置档的发行版本: srm.conf-dist, access.conf-dist 以及httpd.conf-dist 。把它们复制成所需的 srm.conf, access.conf 及httpd.conf 文件。 首先编辑 httpd.conf 。这设定此服务器一般的属性;端口号,执行者的身分等等。接下来编辑 srm.conf 文件;这设定文件树的根目录,指定像是服务端剖析的 HTML 或内部的影像地图(imagemap)剖析等等功能。最後编辑 access.conf 文件,至少作些存取(access)的基本设定。 最後,调用httpd 程序,使用 -f 参数配合 httpd.conf 所在的完整路径。像是,最普遍的例子: /usr/local/etc/apache/src/httpd -f 现在服务器应该已经开始执行。 依照预设 srm.conf 以及 access.conf 这些文件是藉由名称定位的;要藉由其它的名称来指定调用它们的话,可以在 httpd.conf 里面使用AccessConfig 以及 ResourceConfig 指令。
标题? 阿帕奇 HTTP 服务器参考手册 第二章
第二章 启动阿帕奇
httpd 这支程序可以藉由网际网路服务程序 inetd 在每一次有连线要进入 HTTP 服务的时候启动,或者另一种方式,它也可以作为服务程序(daemon)持续地执行,处理请求。无论选择哪一种方式,都必须设定这个 ServerType 指令告诉服务器它要如何执行。
下列选项可以用在 httpd 的命令列上: -d serverroot /usr/local/etc/httpd 。 -f config -X -v -?
此服务器将会读取三个配置指令文件。任何指令都可以出现在这些文件任何一个里面。这些文件的名称是相对於服务器的根目录(server root) ;这是根是藉由 ServerRoot 指令,或是 -d 这个命令列旗标所指定的。依惯例这些文件是: conf/httpd.conf conf/srm.conf conf/access.conf
此服务器也会读取一个包含 MIME 文件型态的文件;这个文件名称藉由TypesConfig 指令设定,而且有个 conf/mini.types 作为预设。
服务程序启动时,它把父程序 httpd 的程序码(process id)存往这个log/httpd.pid 文件。这个文件名称可以配合 PidFile 指令加以改变。这个程序码由管理者用来重新启动或终止服务程序;一个 HUP 信号会使服务程序重新读取其配置档而一个 TERM 信号会使它终止。 如果程序不正常地死掉(或被杀掉),那麽必须杀掉 httpd 子程序。
服务器会将错误讯息记录到一个记录档去,预设为 log/error_log 。文件名称可以藉由 ErrorLog 指令设定;可以为不同的虚拟主机设定不同的错误记录。 2.4.3 传输记录 服务器一般会将每个请求记录到一个传输档,预设为 logs/access_log。文件名称可以藉由 TransferLog 指令设定;可以为不同的虚拟主机设定不同的传输记录。
语法: AccessConfig 文件名称 此服务器读取 ResourceConfig 文件之後将会继续读取这个文件以取得更多指令。文件名称系相对於 ServerRoot 路径。此特色可以使用如下的方式关闭: AccessConfig /dev/null 原本这个文件只包含 节区;事实上它现在可以包含任何可以用於服务器配置的指令。
语法: AccessFileName 文件名称 回传文件给客户端的时候,如果目录的存取控制档有启动,服务器会在到达这份文件的路径中的每个目录里以此名称搜寻存取控制档。例如: AccessFileName .acl 在回传 /usr/local/web/index.html 这份文件前,此服务器将会读取/.acl, /usr/.acl, /usr/local/.acl 以及 /usr/local/web/.acl 以取得指令,除非以如下的方式关闭它们:
3.3 AllowOverride 指令 语法: AllowOverride override override ... 服务器找到 AccessFileName 指定的文件时会需要知道该文件所宣告的哪些指令可以改变稍早的存取资讯。 Override 可以设为 None 在此情况下服务器将不会读取该档,而设为All 的话服务器将会允许所有的指令,或是下列其中之一:
FileInfo Indexes Limit Options
语法: AuthName 验认领域 这个指令为某个目录设定验认区域的名称。这个区域会送给客户端所以使用者知道要传送的使用者名称以及密码。它必须藉由 AuthType 以及require 指令来完成,而且要有像 AuthUserFile 以及 AuthGroupFile这些指令配合运作。
语法: AuthType 型态 这个指令为某个目录选择使用这验认型态。目前只有 Basic 实作出来。它必须藉由 AuthName 以及 require 指令来完成,而且还要有像是AuthUserFile 以及 AuthGroupFile 这些指令配合运作。
语法: BindAddress 服务器位址 一台 Unix 的 http 服务器可以监听到该服务机器每个 IP 位址的连线或者只注意该服务机器的一个位址。服务器位址可以是: 。* 如果此值是 * 的话,那麽该服务器将会监听每一个 IP 位址的连线,否则它将只监听指定的 IP 位址。 这个选项可以用来作为另一种支援虚拟主机的方式取代 节段。
语法: DefaultType mime-型态 有些时候服务器会被要求提供某份文件,此文件不能藉由其 MIME 型态对映来决定型态。 服务器必须知会客户端文件所包含的型态(content-type),所以不知道型态的时候它便使用 DefaultType 。例如: DefaultType image/gif 对於包含许多没有 .gif 副文件名的 gif 图形目录是合适的。
语法: ... 以及 用来把一组指令包装起来,这些指令将只应用到所指明的目录及其子目录上。任何可以用於 directory 的指令都可以使用。Directory 是到某目录的完整路径,或是替代字元串(widecard string) 。在替代字元串中 `?' 能够符合任何单一字元,而 `*' 能够符合任何顺序的一些字元。例如:
AllowOverride FileInfo
。应用 AllowOverride None 指令(关掉 .htaccess 文件)。 这个 directory 节段典型是用在 access.conf 文件里,但它们可以出现在任何配置档里。 指令不能巢状使用,而且不能出现在 节段里。
语法: DocumentRoot 目录名称 这个指令设定 httpd 从这个目录提供文件服务。除非符合像是 Alias这样的指令,服务器把所要求的 URL 附加到文件根 (document root)来组合到达文件的路径。例如: DocumentRoot /usr/web 如此对於 http://www.my.host.com/index.html 文件的存取便会参照到 /usr/web/index.html 。
语法: ErrorDocument 错误代码 文件 有问题或错误发生的状况下,可以配置阿帕奇做四种反应 1. 如同 NCSA httpd 1.3 的反应 2-4 是使用 ErrorDocument 来配置,其後跟随 HTTP 反应码以及讯息或是 URL 。 ErrorDocument 500 /cgi-bin/tester 参阅: 自定回应的文件。
语法: ErrorLog 文件名称 这个错误记录指令设定文件名称,服务器将会把其遭遇的每个错误记录到这个文件去。如果文件名称不是以 / 开始的话那麽它就会被假设为相对於 ServerRoot 的路径。例如: ErrorLog /dev/null 这会有效地关掉错误记录。
语法: Group unix-群组 这个 Group 指令设定服务器回答要求时所处的群组。为了要能够使用这个指令,必须以 root 身分起始执行独立的服务器。 Unix-群组可以是这些其中之一: 群组的名称 # 跟随著群组号码 建议你特别设立一个群组来执行这个服务器。某些管理者使用 nobody这个使用者,但是这并非永远可行或合适的。 注意: 如果你以非 root 使用者的身分启动这个服务器,它将无法切换到指定的群组,并且取而代之的是它将会继续以原来的使用者所属群组来执行。 安全: 参阅 User 指令对安全情况的讨论。
语法: IdentifyCheck 布林值 这个指令为每次的连线起始 RFC931-相容的远端使用者名称记录,其中客户端需得执行 identd 或者是类似的东西。这项资讯记录在存取记录(access log)里。布林值是 on 或者 off 。 除非是作为基本的使用量追踪,这项资讯无论如何不能真的信赖。
语法: ... 以及 用来把一组存取控制指令包装起来,这些指令将只应用到指定的存取方式上,其中的方式是指任何有效的 HTTP 方式(method)。除了 或是 之外的任何指令都可以使用;大部分都不会被 影响。例如:
语法: MaxClients 数字 这个 MaxClients 指令设定所能支援的同时存取要求数目;不会建立比此值还多的子程序。
语法: MaxRequestsPerChild 数字 MaxRequestsPerChild 这个指令设定一个独立的子服务程序将能处理的请求数量。在处理 MaxRequestsPerChild 个请求之後,子程序将会被终止。如果 MaxRequestsPerChild 为 0 的话,那麽该程序永远不会被终止。 MaxRequestsPerChild 设为非 0 的值做为限制有两个好处: 。藉由记忆体使用量限制程序使用的记忆体数量;
语法: MaxSpareServers 数字 MaxSpareServers 这个指令设定最大闲置(idle)子服务程序数量。闲置子服务程序是目前没有处理要求的程序。如果有多於 MaxSpareServers的暂停程序,那麽父程序会终止超过此数量的子程序。 只有在非常忙碌的站台上才有调整这个选项的需要。把这个参数设为非常大的数目通常总是个不好的主意。 参阅 MinSpareServers 以及 StartServers 。
语法: MinSpareServers 数字 MinSpareServers 这个指令设定最大闲置(idle)子服务程序数量。闲置子服务程序是目前没有处理要求的程序。如果有属於 MinSpareServers的暂停程序,那麽父程序会以最高每秒一个的速率建立新的子程序。 只有在非常忙碌的站台上才有调整这个选项的需要。把这个参数设为非常大的数目通常总是个不好的主意。 参阅 MaxSpareServers 以及 StartServers 。
语法: Option 选项 选项 ... Options 这个指令控制某个特定目录所能使用的服务器特色。选项可以设为 NONE 在此情况下没有额外的特色会起动,或者可以是下列的一个或几个: All ExecCGI FollowSymLinks IncludesNOEXEC Indexes MultiViews SymLinksIfOwnerMatch 如果多个选项可以应用到某个目录上,那麽最底下的指定会完成;选项不会合并。例如:
Options Indexes FollowSymLinks
这样只有 Includes 会设定到 /web/docs/spec 目录上。
语法: PidFile 文件名称 PidFile 这个指令设定服务器记录服务程序的程序号码所使用的文件。如果文件名称不是以 / 开始那麽它会被假定是相对於 ServerRoot 的目录。这个 PidFile 只使用在独立(standalone)模式。 能够送个信号给服务器通常会是有用的,可以关闭再重新打开错误记录与传输记录,以及重新读取配置档。这是藉由传送 SIGHUP (kill -1)信号到列在 PidFile 里的程序号码来达成的。
语法: Port 数字 这个 Port 指令设定服务器监听的网路端口号。数字是 0 到 65535 的一个数目;某些端口号(特别是低於 1024 的)保留给特殊的协定。参阅/etc/services 里定义的一些端口的列表;标准 http 协定使用 80 端口。 Port 80 是 Unix's 的一个特别端口。所有低於 1024 的端口号都是保留给系统使用的,例如,一般使用者(non-root)不能使用它们;取而代之的是他们可以使用较高的端口号。 要使用 80 端口你必须以 root 帐号启动服务器。在连接到该端口後,接受请求之前,阿帕奇将会切换为藉由 User 指令所设定权限较低的使用者身分。 如果你不能使用 80 端口,选择任何其它没有使用到的端口。非 root 使用者必须选择高於 1023 的端口号,像是 8000 。 安全: 如果你是以 root 启动服务器,确定不要把 User 设为 root 。如果你以 root 身分处理连线的话,你的站台可能会暴露在攻击下。
语法: require 项目名称 项目 项目 ... 这个指令选择经过验认可以存取目录的使用者。允许使用的语法是: 。require user 使用者辨识码 使用者辨识码 ... 。require group 群组名称 群组名称 ... 。require valid-user 如果 require 出现在 节段里,那麽它会限制所注明的存取方式,否则它会限制所有的存取方式。例如: AuthType Basic
语法: ResourceConfig 文件名称 此服务器读取 httpd.conf 文件之後将会继续读取这个文件以取得更多指令。文件名称系相对於 ServerRoot 路径。此特色可以使用如下的方式关闭: ResourceConfig /dev/null 原本这个文件包含大部分指令,除了服务器配置及 节区以外;事实上它现在可以包含任何可以用於服务器配置的指令。
语法: ServerAdmin 电子邮件地址 ServerAdmin 设定电子邮件地址,服务器回传任何错误讯息给客户端时会包含这个地址。 设定一个像这样的地址可能会有用,例如 ServerAdmin www-admin@foo.bar.com 因为使用者并不会永远知道他们是跟在哪台服务器打交道!
语法: ServerName 完整的领域名称 这个 ServerName 指令设定服务器的主机名称;这只有在建立重导 URL的时候使用。如果没有指定它,那麽服务器会试图从其 IP 位址来决定;然而这个方法可能不能信赖,或者无法回传适当的主机名称。例如: ServerName www.wibble.com 如果正式(canonical) 名称是 monster.wibble.com 它还能够使用上述的名称。
语法: ServerRoot 目录名称 这个 ServerRoot 指令设定服务器所在的目录。它典型会包含有子目录conf/ 以及 logs/ 。其它配置档的相对路径是相对於这个路径。
语法: ServerType 型态 这个 ServerType 指令设定系统如何执行这个服务器。型态可以是其中之一: inetd standalone inetd 在这两个选项里是较少使用的。因为接收到每个 http 连线就会重头开始执行一份新的服务器拷贝;连线结束後,这支程序就会结束。每次连线要付出的代价很高,但是因为安全上的理由,某些管理者喜欢这个选项。 standalone 是 ServerType 使用最普遍的设定,因为它更为有效率。服务器启动一次,而且服务所有的连线。如果你想要执行阿帕奇来服务一个忙碌的站台, standalone 大概将会是你唯一的选择。 安全: 如果你对安全性有偏执,以 inetd 模式来执行它。两种方式都不能绝对确保安全性,但是大部分人使用 standalone 用得很高兴时,inetd 大概比较不会遭到攻击。
语法: StartServers 数字 这个 StartServers 指令设定启动时建立的子服务程序数量。因为程序的数量是依据负载动态控制的,通常没有什麽理由得要调整这个参数。 参阅 MinSpareServers 以及 MaxSpareServers 。
语法: TimeOut 数字 TimeOut 这个指令设定服务器接收一个请求以及完成一个请求最长的等待时间,以秒为单位。所以如果它花费比 TimeOut 更多秒来让客户端传送请求或接收回应,服务器将会中断该连线。因此 TimeOut 限制一次可以传输的最大资料量;对於大文件,以及慢速网路传输时间可能会很久。
语法: User 使用者辨识码 User 这个指令设定服务器用来回答请求的使用者辨识码。为了要能够使用这个指令,必须以 root 身分起始执行独立的服务器。Unix使用者辨识码可以是其中之一: 一个使用者名称 # 跟随著使用者编号 这个使用者应该不能有存取外界所不能看到的文件的权限,而且与此类似,这个使用者应该不能执行对 httpd 要求而言没有意义的程序码。建议你特别为执行这个服务器设立新的使用者以及群组。某些管理者使用 nobody 但是这并非永远可行或合适的。 注意: 如果你以非 root 使用者的身分启动这个服务器,它将无法切换到权限较低的使用者,并且取而代之的是它将会继续以原使用者身份来执行。如果你真的是以 root 启动这个服务器,那麽这个父程序一般仍然以 root 身分在执行。 安全: 不要把 User(or Group) 设为 root 除非你确实知道你在做什麽以及会有怎麽样的危险。
语法: ... 以及 用来把一组指令包装起来,这些指令将只会应用到某个特定的虚拟主机上。任何可用於虚拟主机的指令都可以使用。当服务器接收到某个特定主机上的文件请求的时候,它会使用包装在 节段里的配置指令。位址可以是。虚拟主机的 IP 位址。虚拟主机的 IP 位址的完整领域名称。 □例:
第四章 阿帕奇标准模组
这个模组包含在 mod_access.c 文件里,而且依预设会编译进去。它提
语法: allow from 主机 主机 ... allow 这个指令影响能够存取某特定目录的主机;典型是用在 all (部份)领域名称 完整的 IP 位址 部份的 IP 位址 □例: allow from .ncsa.uiuc.edu 允许在指定领域里的所有主机进行存取。 注意这比较的是整个的内容;所以 bar.edu 不会符合 foobar.edu 。 参阅 deny 以及 order 指令。
语法: deny from 主机 主机 ... deny 这个指令影响能够存取某特定目录的主机;典型是用在 all (部份)的领域名称 完整的 IP 位址 部份的 IP 位址 □例: deny from 16 拒绝在指定网路里的所有主机进行存取。 注意这比较的是整个的内容;所以 bar.edu 不会符合 foobar.edu 。 参阅 allow 以及 order 指令。
语法: order 次序 order 这个指令控制评估 allow 以及 deny 指令的次序。次序可以是 deny,allow allow,deny mutual-failue □例: order deny,allow deny from all allow from .ncsa.uiuc.edu 允许在 ncsa.uiuc.edu 这个领域里的主机进行存取;拒绝所有其它的
这个 mod_alias 模组包含在 mod_alias.c 文件里,而且依预设会编
语法: Alias url-路径 目录-文件名称 Alias 这个指令使文件可以存放在 DocumentRoot 之外的本地文件系统 Alais /image /ftp/pub/image 对於 http://myserver/images/foo.gif 的这个请求会使得服务器回传 参阅 ScriptAlias 指令。
语法: Redirect url-路径 url Redirect 这个指令对映旧的 URL 到新的去。新的 URLs 会被回传给 Redirect /service http://foo2.bar.com/service 如果客户端请求 http://myserver/service/foo.txt 则会被告知应该 注意: 无论配置档里的次序如何,Redirect 指令优先於 Alias 以及
语法: ScriptAlias url-路径 目录-文件名称 ScriptAlias 这个指令除了还另外把目标目录标记为包含 CGI 指令稿 ScriptAlias /cgi-bin/ /web/cgi-bin/ 对於 http://myserver/images/foo 的这个请求会使服务器去执行指令
这个模组包含在 mod_asis.c 文件里,而且依预设会编译进去。它是为
允许定义文件的型态,如此阿帕奇可以不加 HTTP 标头(headers) 传送 这可以用来从服务器传送任何型态的资料,包括重导(redirects) 以及
在服务器配置档里,定义一个称为 httpd/send-as-is 的 mime 型态, AddType httpd/send-as-is asia 这定义 .asis 副文件名是新的 httpd/send-as-is mime 型态。任何副 这里有个示例档,其内容是告诉客户端有个文件被重定向送出。 Status: 302 Now where did I leave that URL
Fred's exceptionally wonderful page has moved to
注意: 服务器一定会在送给客户端的资料里加上 Date: 以及 Server:
这个模组包含在 mod_auth.c 文件里,而且依预设会编译进来。它提供
语法: AuthGroupFile 文件名称 AuthGroupFile 这个指令设定一个文本文件的名称,这个文本文件包含用来 这个群组文件的每一行包括一个群组名称,跟随一个冒号,其後是藉由 mygroup: bob joe anne 注意搜寻很大的群组文件是很没有效率的;应该用 AuthDBMGroupFile 安全: 确定这个 AuthGroupFile 储放在服务器的文件树之外;不要把 参阅 AuthName, AuthType 以及 AuthUserFile 。
语法: AuthUserFile 文件名称 这个 AuthUserFile 指令设定一个文本文件的名称,这个文本文件包含用来 这个使用者文件的每一行包括一个使用者名称,跟随一个冒号,其後是 注意搜寻很大的使用者文件是很没有效率的;应该用 AuthDBMUserFile 安全: 确定这个 AuthUserFile 储放在服务器的文件树之外;不要把它 参阅 AuthName, AuthType 以及 AuthGroupFile 。
这个模组包含在 mod_cgi.c 文件里,而且依预设会编译进来。它提供
任何拥有 application/x-httpd-cgi 之 mime 型态的文件都会被当作 当服务器启动一个 CGI 指令稿时,它将加上一个称为 DOCUMENT_ROOT
这个服务器将会设立定义在 CGI 规格中的 CGI 环境参数,配合下列 REMOTE_HOST REMOTE_IDENT REMOTE_USER
这个模组包含在 mod_dir.c 文件里,而且依预设会编译进来。它提供
这个模组控制目录索引。目录的索引可以有两种来源: 。一个由使用者所撰写的文件,典型是称为 index.html 的文件 。另一种是由服务器所产生的列表。其它的指令控制这个列表的
语法: AddDescription 字串 文件 文件 ... 这是设定某文件所要显示的描述,供象徵索引(FancyIndexing) 使用。 AddDescription "The planet Mars" /web/pics/mars.gif
语法: AddIcon 图示 名称 名称 ... 这设定显示在文件名称之後的图示供作象徵索引之用。图示可以是某个 对於目录可以使用 ^^DIRECTORY^^ 这个名称,^^BLANKICON^^ 可以用 AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm 可能的话,使用 AddIconByType 应该比 AddIcon 好。
语法: AddIconByEncoding icon mime-encoding mime-encoding ... 这设定显示在有 mime-encoding 的文件名称之後的图示供作象徵索引 Mime-encoding 是个符合要求之编码内容的替代字元表示式。例如: AddIconByEncoding /icons/compress.xxbm x-compress
语法: AddIconByType icon mime-type mime-type ... 这设定显示在 mime-type 的文件名称之後的图示供作象徵索引之用。 Mime-encoding 是个符合要求之 mime 型态的替代字元表示式。例如: AddIconByType (IMG, /icons/image.xbm) image/*
语法: DefaultIcon url DefaultIcon 这个指令设定当不知道指定的图示为何时显示的图示供作 DefaultIcon /icon/unknow.xbm
语法: DirectoryIndex local-url local-url DirectoryIndex 这个指令设定当客户端藉由指定没有以文件做结尾的 DirectoryIndex index.html 然後,对於 http://myserver/docs/ 的请求若该来源设定的文件存在 注意该文件并不需要是相对於该目录的: DirectoryIndex index.html index.txt /cgi-bin/index.pl 这会使得 /cgi-bin/index.pl 这个 CGI 指令稿在 index.html 以及
语法: FancyIndexing 布林值 FancyIndexing 此指令设定目录的象徵索引选项。布林值可以是 on 或
语法: HeaderName 文件名称 HeaderName 这个指令设定插入索引列示顶部的文件名称。当案名称是 HeaderName HEADER 当产生 /web 目录的索引时,服务器首先将会找寻 /web/HEADER.html 参阅 ReadmeName 。
语法: IndexIgnore 文件 文件 ... IndexIgnore 这个指令把列出目录时要隐藏的文件加到列表中。文件 IndexIgnore README .htaccess *~
语法: IndexOptions 选项 选项 ... IndexOptions 这个指令指定进行目录索引时的动作。选项可以是下列 FancyIndexing IconsAreLinks ScanHTMLTitles SuppressModified SuppressSize SuppressDescription 预设是没有打开任何一个选项。如果有多个 IndexOptions 可以应用到
语法: ReadmeName 文件名称 ... ReadmeName 这个指令要附加到索引列示後面的文件之名称。文件名称 ReadmeName README 当产生 /web 目录的索引时,服务器首先将会找寻 /web/README.html 参阅 HeaderName 。
这个模组包含在 mod_imap.c 文件里,而且依预设会编译进来。它是为 4.7.1 摘要 为了使用服务端剖析(server-parsed) 的影像地图(imagemap)档,你首 AddType application/x-httpd-imap map
imagemap 这个模组加入了一些先前发行的 iamgemap 程序版本不可能
refer http://whateverurl
default http:/lincoln/
4.8 mod_include 模组 这个模组包含在 mod_include.c 文件里,而且依预设会编译进来。它
这种文件被当作 HTML 文件剖析,并如同 SGML 的注解嵌入(embedded)
这里的值常包括在双引号里;许多指令只允许单一个属性-值的配对。 允许使用的项目是: config errmsg sizefmt timefmt echo var exec cgi cmd fsize file virtual flastmod include file virtual URL 是由属性建构的,如果客户端请求的 URL 包含在被剖析的
这些参数可以提供给 echo 指令,以及任何由文件起动的程序取用。 DATE_GMT DATE_LOCAL DOCUMENT_NAME DOCUMENT_URI LAST_MODIFIED
语法: XBitHack 状态 XBitHack 这个指令控制一般 html 文件的剖析。状态可以是下列值: off on full
这个模组包含在 mod_log_common.c 文件里,而且依预设会编译进来。
对於每个请求记录档包含个别的一行。一行是由数个以空白间隔的记 host ident authuser date request status bytes 如果某个记号没有值就会以短线(-) 表示。这些记号以及其代表的意义 host ident authuser date request status bytes
语法: TransfetLog 文件-管线 TransferLog 这个指令设定服务器记录进入之请求的文件名称。文件- 一个文件名称 `|' 跟随著一个指令 安全: 如果在此使用程序,它将会以起动 httpd 的使用者身分执行。
这个模组包含在 mod_mime.c 文件里,而且依预设会编译进来。他提供
这个模组用来决定文件的 mime 型态。某些 mime 型态会指出服务器得 文件的文件名称被当作基本名称的一部份,其後跟随某些副文件名,次序 base.type.language.enc 其中 type 这个副文件名设定文件的型态,型态定义在 TypesConfig 文件
语法: AddEncoding mime-enc 副文件名 副文件名 AddEncoding 这个指令以指定的编码型态把可能作为文件名称结尾的副 AddEncoding x-gzip gz 这将会使以 .gz 结尾的文件被标记为使用 z-gzip 编码,以及 .Z 结
语法: AddLanguage mime-lang 副文件名 副文件名 第五章 阿帕奇扩充模组
这个模组包含在 mod_auth_dbm.c 这个文件里,而且依预设不会编译进
语法: AuthDBMGroupFile 文件名称 AuthDBMGroupFile 这个文件设定作为验认用的 DBM 文件名称,其中 这个文件是以使用者名称作为关键。而使用者後的值则是该使用者所属 安全: 确定 AuthDBMGroupFile 存放在服务器的文件树之外;不要把它 参阅 AuthName, AuthType 以及 AuthDBMUserFile 。
语法: AuthDBMUserFile 文件名称 AuthDBMUserFile 这个文件设定作为验认之用的 DBM 文件名称,其中 这个文件是以使用者名称作为关键。使用者後的值是 crypt() 加密过 安全: 确定 AuthDBMUserFile 存放在服务器的文件树之外;不要把它 参阅 AuthName, AuthType 以及 AuthDBMGroupFile 。
这个模组包含在 mod_cookies.c 这个文件里,而且依预设不会编译进
语法: CookieLog 文件名称 CookieLog 这个指令设定记录 cookies 用的文件名称。这个文件名称
这个模组包含在 mod_dld.c 这个文件里,而且依预设不会编译进去。
这个选用性的 dld 模组是一段作为观念证明(proof-of-concept)用的 注意因为某些缘故,LoadFile /lib/libc.a 看来似乎是必须的。 注意: 当服务器起动时 DLD 需要读取在服务器程序之外的符号表格;
语法: LoadFile 文件名称 文件名称 ... LoadFile 这个指令在服务器起动时链结其所指名的目的档或程序库;
语法: LoadModule 模组 文件名称 LoaddModule 这个指令链结目的档或程序库的文件名称并且把所指名的 LoadModule ai_backcompat_module modules/mod_ai_backcompat.o 载入 ServerRoot 里的 modules 子目录下的模组。
这个模组包含在 mod_log_agent.c 这个文件里,而且依预设不会编译
语法: AgentLog 文件-管线 AgentLog 这个指令设定服务器记录进入之请求的文件名称,其内容为
`|' 跟随著一个指令
这个模组包含在 mod_log_config.c 这个文件里,而且依预设不会编译
这是个实验性质的模组,它实作 TransferLog 这个指令(与一般记录 LogFormat 的参数是个字串,可以包含要复制到记录档里的文字,以及 %...h: 远端主机 %...b: 送出的位元组 `...' 这个部份可以完全不要(e.g. "%h %u %r %s %b") ,或者它可以 条件的形式是一份 HTTP 状态码的列表,可能有也可能没有 `!' 前导 预设的 LogFormat 重现 CFL; 如下。 配合虚拟主机使用的想法如下: 虚拟主机可以拥有它自己的 LogFormat 这意谓你可以像这样做:
LogFormat "hostb ..."
语法: LogFormat 字串 这设定记录档的格式。
语法: TransferLog 文件-管线 TransferLog 这个指令设定服务器记录进入之请求的文件名称。文件-
`|' 跟随著一个指令
这个模组包含在 mod_log_refer.c 这个文件里,而且依预设不会编译
记录档为每个参考记录个别的一行。每一行的格式 uri -> 文件 其中 uri 是客户端要求所参考之文件的(%-escaped) URI ,而文件则
语法: RefererIgnore 字串 字串 ... RefererIgnore 这个指令把要忽略的参考标头(Referer headers) 加入 RefererIgnore www.ncsa.uiuc.edu 这会避免记录来自 www.ncsa.uiuc.edu 的参考。
语法: RefererLog 文件-管线 RefererLog 这个指令设定服务器记录进入之请求的文件名称,其内容
`|' 跟随著一个指令
|
| webasp.net |