描述指令的术语
本文对用于描述Apache配置指令的术语加以说明。
说明
对指令用途的简单说明。
ServerRoot的相对路径。
directory-path
目录在本地文件系统中相对于根目录的路径,如:/usr/local/apache/htdocs/path/to/
filename
不带路径信息的文件名,如:file.html
regex
Perl兼容的正则表达式,是对文本匹配模式的描述。指令的定义中会说明应该使用什么regex 。
extension
一般是指filename中最后一个"."号后面的部分。不过,Apache可以辨认文件的多个extension ,如果filename中含有多个".",则第一个"."后面由每个"."分隔开的部分都是此文件的extension 。比如"file.html.en
"有两个extension :.html
和.en
。在Apache指令中指定extension时,可以有也可以没有前导的".",而且不区分大小写。
MIME-type
一种用一个主格式类型和一个副格式类型并用斜杠分隔的描述文件格式的方法,如:text/html
env-variable
这是Apache配置过程中定义的环境变量的名称。注意,它不一定与操作系统中的环境变量相同。详情参见环境变量文档。
/usr/local/apache/htdocs/path/to/
file.html
file.html.en
"有两个extension :.html
和.en
。在Apache指令中指定extension时,可以有也可以没有前导的".",而且不区分大小写。text/html
默认值
如果该指令有默认值(即如果你没有在配置中明确指定,那么Apache服务器会默认设置一个特定的值,并认为它是你设置的),会在此处说明。如果没有,则会指明是"None"。注意,此处的默认值并不一定与服务器发行版中默认的httpd.conf中该指令的取值相同。
<VirtualHost>或<Directory>
段以及.htaccess
文件中。
virtual host
说明该指令可以用于服务器配置文件的<VirtualHost>
段中。
directory
说明该指令可以用于服务器配置文件<Directory>
, <Location>
, <Files>
, <Proxy>
段中,并服从配置段一文的限制。
.htaccess
说明该指令可以用于针对单个目录及其子目录的.htaccess
文件中。它可能会因overrides的设置而不起作用。
<VirtualHost>
段中。<Directory>
, <Location>
, <Files>
, <Proxy>
段中,并服从配置段一文的限制。.htaccess
文件中。它可能会因overrides的设置而不起作用。指令应该仅仅出现在允许出现的作用域中,否则会产生配置错误,并导致服务器不能正确处理请求,或者根本不能启动。
指令的有效位置,事实上是其所有被列出的作用域逻辑或的结果。也就是如果一个指令被标为"server config, .htaccess
"则可以用于httpd.conf
和.htaccess
,但不能用于任何<Directory>
或<VirtualHost>
容器。
作用域不包含.htaccess
,则无此内容。
AllowOverride
指令使覆盖生效,并作用于一个特定的范围(比如一个目录)及其下分支,除非又被其下层中其他的AllowOverride
指令所修改。对指令的说明中同时列出了其可能的覆盖项。
多路处理模块提供,此类指令仅仅在使用了指令定义中模块一行所列的MPM之一时才有效。
Base
由默认编译进服务器的一个Apache标准模块提供,一般总是有效的,除非你刻意在编译时从配置中删除此模块。
Extension
由一个默认不被编译进服务器的模块提供。要激活此指令并使用其功能,需要修改服务器编译时配置并重新编译Apache。
Experimental
由一个一般来说默认不被编译进服务器的模块提供,并且需要你自己承担使用中的风险。对此指令提供文档是为了保持完整性,而并不一定有技术支持。提供此指令的模块,是否默认被编译进入服务器都有可能,其说明页面的顶部注明了其有效性。
模块
对该指令提供支持的模块列表。
兼容性
如果该指令不是原始Apache2的发行版的一部分,此处会写明此指令应该被使用于哪个版本;另外,如果此指令在特定平台上有功能限制,此处会有详细说明。