用于描述指令的术语

描述

简要描述指令的目的。

语法

这指示了指令在配置文件中出现的格式。此语法非常特定于指令，并在指令的定义中详细描述。通常，指令名称后跟一个或多个空格分隔的参数。如果参数包含空格，则参数必须用双引号括起来。可选参数用方括号括起来。如果参数可以取多个可能的值，则可能的值用竖线 "|" 分隔。文字文本以默认字体显示，而需要替换的参数类型则以 *斜体* 显示。可以接受可变数量参数的指令将以 "..." 结尾，表示最后一个参数重复。

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

URL

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

URL-路径

url 中跟随方案和主机名的部分，如 /path/to/file.html。url-path 代表资源的 Web 视图，而不是文件系统视图。

文件路径

本地文件系统中文件的路径，以根目录开头，如 /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

如果指令在此上下文中有效，则意味着它可以出现在每个目录的 .htaccess 文件中。但是，它可能不会被处理，这取决于当前活动的 覆盖。

指令 *只* 允许在指定的上下文中使用；如果您尝试在其他地方使用它，您将收到一个配置错误，该错误要么阻止服务器在该上下文中正确处理请求，要么阻止服务器完全运行 - *即*，服务器甚至不会启动。

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

覆盖

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

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

状态

这指示了指令与 Apache Web 服务器的绑定程度；换句话说，您可能需要使用增强模块集重新编译服务器才能访问指令及其功能。此属性的可能值为

核心

如果指令被列为具有“核心”状态，则意味着它是 Apache Web 服务器最内层部分的一部分，并且始终可用。

MPM

标记为具有“MPM”状态的指令由 多处理模块 提供。仅当您使用 模块 行中列出的 MPM 之一时，此类型的指令才可用。

基础

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

扩展

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

实验性

“实验性”状态表示指令作为 Apache 套件的一部分可用，但如果您尝试使用它，则需要自行承担风险。该指令已记录在案以确保完整性，并不一定受支持。提供该指令的模块可能默认情况下已编译或未编译；请检查描述该指令及其模块的页面顶部，以查看它是否对可用性进行了说明。

模块

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

兼容性

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