用于描述指令的术语

描述

指令用途的简要说明。

句法

这指示指令的格式，就像它出现在配置文件中一样。该语法与指令极为相关，在指令的定义中有详细说明。通常，伪指令名称后跟一系列由一个或多个以空格分隔的参数。如果参数包含空格，则参数必须用双引号引起来。可选参数放在方括号中。如果一个参数可以采用多个可能值，则可能的值由竖线“ |”分隔。文字文本以默认字体显示，而强调必须替换的参数类型 。可以采用可变数量参数的指令将以“ ...”结尾，表示重复了最后一个参数。

指令使用大量不同的参数类型。以下是一些常见的定义。

网址

完整的统一资源定位符，包括方案，主机名和可选路径名，如 http://www.example.com/path/to/file.html

网址路径

网址中遵循方案和主机名的部分，如中所示/path/to/file.html。该 URL路径表示资源的网络视图，而不是一个文件系统视图。

文件路径

本地文件系统中文件的路径，从根目录开始，如中所示 /usr/local/apache/htdocs/path/to/file.html。除非另有说明，否则不以斜杠开头的文件路径将被视为相对于ServerRoot 的路径。

目录路径

本地文件系统中目录的路径，从根目录开始，如中所示 /usr/local/apache/htdocs/path/to/。

文件名

文件名称，没有附带的路径信息，如中所示file.html。

正则表达式

与Perl兼容的正则表达式。指令定义将指定 正则表达式要匹配的对象。

延期

通常，这是文件名 中最后一个点之后的部分。但是，Apache可以识别多个文件扩展名，因此，如果一个文件名 包含多个点，则第一个点后的文件名中每个点分隔的部分都是扩展名。例如，文件名 file.html.en 包含两个扩展名：.html和 .en。对于Apache指令，您可以指定 带有或不带有前导点的扩展名。另外，扩展名不区分大小写。

MIME类型

一种描述文件格式的方法，该文件由主要格式类型和次要格式类型组成，并以斜杠分隔，如中所示text/html。

环境变量

在Apache配置过程中定义的环境变量的名称。请注意，这不一定与操作系统环境变量相同。有关更多详细信息，请参见环境变量文档。

默认

如果该指令具有默认值（即，如果您完全从配置中省略该指令，则Apache Web服务器的行为就像您将其设置为特定值一样），在此进行说明。如果没有默认值，此部分应显示“ 无 ”。请注意，此处列出的默认值不一定与该指令在随服务器分发的默认httpd.conf中采用的值相同。

语境

这表明该指令在服务器的配置文件中的合法位置。这是一个或多个以下值的逗号分隔列表：

服务器配置

这意味着，该指令可以在服务器配置文件（可以使用例如，httpd.conf），但 不内的任何 <VirtualHost> 或<Directory> 容器。完全不允许在.htaccess文件中使用。

虚拟主机

此上下文意味着该指令可能出现在<VirtualHost> 服务器配置文件中的容器内 。

目录

标记为在这方面是有效的一项指令，可以内部使用<Directory>，<Location>，<Files>，<If>，并<Proxy>在服务器配置文件容器，受中列出的限制配置部分。

.htaccess

如果指令在这种情况下是有效的，这意味着它可以在里面出现每 -directory .htaccess文件。尽管取决于当前激活的替代，它可能不会被处理。

该指令仅在指定的上下文中才允许；如果尝试在其他地方使用它，则会收到配置错误，该错误将阻止服务器在该上下文中正确处理请求，或者使服务器完全无法运行- 即，服务器甚至无法启动。

该指令的有效位置实际上是所有列出的上下文的布尔或的结果。换句话说，被标记为在“无效的指令server config, .htaccess”，可以在使用的 httpd.conf文件和.htaccess 文件，但没有任何内部<Directory>或 <VirtualHost> 容器。

覆写

此伪指令属性指示当该伪指令出现在.htaccess文件中时，必须激活哪个配置替代才能对其进行处理。如果指令的上下文 不允许它出现在.htaccess文件中，则不会列出任何上下文。

覆盖由该AllowOverride指令激活，并且适用于特定作用域（例如目录）和所有后代，除非由AllowOverride较低级别的其他指令进一步修改 。该指令的文档还列出了可用的可能的替代名称。

状态

这表明该指令与Apache Web服务器的绑定程度。换句话说，您可能需要使用一组增强的模块来重新编译服务器，以便获得对指令及其功能的访问。该属性的可能值为：

核心

如果指令被列为具有“ Core”状态，则表示它是Apache Web服务器最内部的一部分，并且始终可用。

MPM

多处理模块提供了标记为具有“ MPM”状态的指令。当且仅当您使用指令定义的“ 模块”行上列出的MPM之一时，这种类型的指令才可用。

基础

标准Apache模块之一支持标记为“基本”状态的指令，该指令默认情况下已编译到服务器中，因此通常可用，除非您已采取措施从配置中删除该模块。

延期

Apache服务器工具包随附的模块之一提供了状态为“扩展”的指令，但是该模块通常不会编译到服务器中。要启用该指令及其功能，您将需要更改服务器构建配置文件并重新编译Apache。

实验性

“实验性”状态表示该指令可作为Apache工具包的一部分使用，但是如果您尝试使用它，则只能靠自己了。对该指令进行了记录以确保完整性，不一定支持该指令。提供指令的模块默认情况下可能会编译，也可能不会编译。检查描述该指令及其模块的页面顶部，以查看其是否对可用性进行了说明。

模组

这很简单地列出了定义指令的源模块的名称。

兼容性

如果该指令不是原始Apache版本2发行版的一部分，则应在此处列出引入该指令的版本。此外，如果该指令仅在某些平台上可用，请在此处注意。