Apache模块 core

AcceptPathInfo 指令

此指令决定了是否接受包含在某确定文件(或是某现有目录的一个不存在的文件)后附加的路径信息。此路径信息将在脚本里以PATH_INFO环境变量的形式出现。

比如说，假设"/test/"所指向的目录下只包括一个文件：here.html，那么对"/test/here.html/more"和"/test/nothere.html/more"的请求都会得到"/more"这样的PATH_INFO变量。

AcceptPathInfo 指令的三个参数为：

Off

仅当一个请求映射到一个真实存在的路径时，它才会被接受。这样，如上述"/test/here.html/more"这样的在真实文件名后跟随一个路径名的请求将会返回一个"404 NOT FOUND"错误。

On

如果前面的路径映射到一个真实存在的文件，此请求将被接受。如果"/test/here.html"映射着一个有效的文件，上例中"/test/here.html/more"这个请求就会被接受。

Default

对于附加路径名的请求的处理方式由其对应的处理器来决定。对应普通文本的核心处理器默认会拒绝PATH_INFO。而用于伺服脚本的处理器，比如cgi-script和isapi-isa，默认会接受PATH_INFO。

AcceptPathInfo指令存在的首要目的就是允许您覆盖处理器关于是否接受PATH_INFO的默认设置。这种覆盖是很必要的。比如说，当您使用了类似INCLUDES这样的过滤器来根据PATH_INFO产生内容时。核心处理器通常会拒绝这样的请求，而您就可以用下述的配置使这样的脚本成为可能：

AccessFileName 指令

当向客户端返回文档时，如果设置了此目录的分布式配置文件功能。服务器将在这个文档的各个路径中从名字列表中查找第一个存在的配置文件。比如说：

在返回文档"/usr/local/web/index.html"之前，服务器会为此指令读取/.acl，/usr/.acl，/usr/local/.acl和/usr/local/web/.acl除非此功能以为如下代码所禁用：

参见

• AllowOverride
• 配置文件
• .htaccess文件

AddDefaultCharset 指令

当且仅当应答内容是text/plain或text/html时，此指令将会在HTTP应答头中加入的默认字符集。这将覆盖在文档体中通过<meta>标签指定的字符集。AddDefaultCharset Off 这样的设置将会禁用此功能。AddDefaultCharset On 将根据此指令的需要启用Apache内部的默认字符集iso-8859-1。您也可以指定使用在IANA注册过的字符集名字中的另外一个字符集。比如说：

AddDefaultCharset 只应当在如下情况下使用：所有文本资源都使用同一种确定的字符集，且分别标记他们的字符集非常麻烦。注意，设置了默认的字符集以后将会使得浏览器的字符集自动探测功能失效。

参见

• AddCharset

AddOutputFilterByType 指令

此指令根据应答的MIME类型对请求激活特定的输出过滤器。

下例使用了由mod_deflate提供的DEFLATE过滤器。它将把所有以text/html或text/plain 为标记的输出(不论静态或动态)在发送到客户端之前进行压缩。

如果您希望用多个过滤器来对内容进行处理，您可以用分号来分隔它们的名字。并对每个过滤器使用AddOutputFilterByType 指令。

下述配置将使所有标记为text/html的脚本输出首先被INCLUDES过滤器处理然后被DEFLATE过滤器处理。

参见

• AddOutputFilter
• SetOutputFilter
• 过滤器

AllowEncodedSlashes 指令

AllowEncodedSlashes 指令允许使用包含经过编码的路径分割符的URL("%2F"→"/"或"%5C"→"\"，取决于不同的系统)。默认情况下，这些URL将被一个包含"404 (Not found)"错误的应答拒绝。

"AllowEncodedSlashes On"通常和PATH_INFO配合使用。

参见

• AcceptPathInfo

AllowOverride 指令

当服务器发现了一个.htaccess文件(由AccessFileName指定)时，它需要知道在这个文件中声明的哪些指令能覆盖在此之前指定的配置指令。

如果此指令设置为"None"，那么.htaccess文件将被完全忽略。在这种情况下，服务器甚至都不会读取.htaccess文件。

当此指令设置为"All"时，所有具有.htaccess作用域的指令都允许出现在.htaccess文件中。

directive-type 可以是下列各组指令之一：

AuthConfig

允许使用授权认证的指令 (AuthDBMGroupFile, AuthDBMUserFile, AuthGroupFile, AuthName, AuthType, AuthUserFile, Require, 等).

FileInfo

允许使用控制文档类型的指令 (DefaultType, ErrorDocument, ForceType, LanguagePriority, SetHandler, SetInputFilter, SetOutputFilter, mod_mime中的 Add* 和 Remove* 指令, 等).

Indexes

允许使用目录索引的指令 (AddDescription, AddIcon, AddIconByEncoding, AddIconByType, DefaultIcon, DirectoryIndex, FancyIndexing, HeaderName, IndexIgnore, IndexOptions, ReadmeName, 等).

Limit

允许使用主机访问控制的指令 (Allow, Deny和Order).

Options

允许使用控制指定目录功能的指令 (Options和XBitHack).

例如以下指令只允许AuthConfig和Indexes组的指令：

参见

• AccessFileName
• 配置文件
• .htaccess文件

AuthName 指令

此指令为目录的验证域设置了名字。此域将发送给客户端以使用户了解应当发送哪个用户名和密码。AuthName指令带有一个参数。如果域的名字中包含空格，它必须用引号引起来。它必须与AuthType和Require指令以及诸如AuthUserFile和AuthGroupFile这样的指令一起工作。

举例如下：

提供给AuthName的字符串将出现在大多数浏览器提供的密码对话框中。

参见

• 认证，授权和访问控制

AuthType 指令

此指令选择了一个目录的用户验证的类型。目前只实现了Basic和Digest。它必须和AuthName和Require指令以及诸如AuthUserFile和AuthGroupFile这样的指令一起使用。

参见

• 认证，授权和访问控制

CGIMapExtension 指令

此指令用于控制Apache发现CGI脚本的解释器。比如说"CGIMapExtension sys:\foo.nlm .foo"这样的设置将把所有具有".foo"扩展名的CGI脚本文件传递给FOO解释器。

ContentDigest 指令

此指令遵照RFC1854和RFC2068协议定义启用了Content-MD5应答头的生成。

MD5是一种为不定长度(arbitrary-length)的数据计算出一个"消息摘要"(有时也称为"指纹")的算法。并且保证数据中的任何变化都会反应在消息摘要的变化当中。

Content-MD5头提供了一种端到端的针对整个消息体的完整性检测方法。代理或者客户端会检查此头以侦测在传输过程中，消息体是否产生了意外的改变。一个头的例子如下：

请注意，因为对于每个请求都要进行消息摘要的运算(没有对其值进行缓存)，所以这会对您的服务器造成性能方面的问题。

Content-MD5仅为由核心伺服的文档进行发送，而对于模块将不予理会。比如说SSI文档，CGI脚本的输出和字节范围的应答都不包括这个头。

DefaultType 指令

有时会发生这样的事：服务器会被要求提供一个文档，而这个文档的类型无法由它的MIME类型映射所决定。

服务器必须通知客户端其文档的内容类型。所以当一个未知类型出现时，将会使用DefaultType。比如说：

这样的配置对于里面有很多gif图片而有些在文件名中缺少".gif"扩展名的目录非常合适。

注意：与ForceType指令的不同之处在于：此指令仅提供了默认的mime类型。所有其它mime类型的定义，包括文件的扩展名，或那些可以标识一种媒体类型的都会覆盖此默认值。

<Directory> 指令

<Directory>和</Directory> 用于封装一组指令，使之仅对某个目录及其子目录生效。任何在"directory"作用域中可以使用的指令都允许在这种情况下使用。Directory-path 可以是一个目录的完整路径，或是包含了Unix shell匹配语法的通配符字串。在通配符字串中，"?"匹配任何单个的字符，"*"匹配任何字符序列。您也可以使用"[]"来确定字符范围。以上通配符都不能匹配"/"字符。所以<Directory /*/public_html>将无法匹配/home/user/public_html，但<Directory /home/*/public_html>能够正确匹配。比如说：

扩展的正则表达式也可以通过附加一个"~"字符来使用。比如说：

将匹配"/www/"下的所有由3个数字组成的目录。

如果有多个(非正则表达式)<Directory>配置段符合包含某文档的目录(或其父目录)，那么指令将以最短目录最先应用的规则进行应用。并包含.htaccess文件中的指令。比如说在

中，访问文档/home/web/dir/doc.html的步骤如下：

• 应用指令AllowOverride None(禁用.htaccess文件)。
• 应用指令AllowOverride FileInfo(针对目录/home/web)。
• 应用所有/home/.htaccess, /home/web/.htaccess和/home/web/dir/.htaccess中的FileInfo组指令。

正则表达式将在所有普通配置段应用后才予以考虑。所有的正则表达式将根据它们出现在配置文件中的顺序进行验证。比如说，以下配置：

正则表达式配置段将在所有普通的<Directory>和.htaccess文件应用后才予以考虑。所以正则表达式将匹配/home/abc/public_html/abc并予以应用。

请注意：Apache对<Directory /> 的默认访问权限为"Allow from All"。这意味着Apache将伺服任何通过URL映射的文件。我们建议您将这个配置做如下屏蔽：

然后在您想要使之被访问的目录中覆盖此配置。参阅安全提示页获取更多详情。

一般来说，<Directory>指令会出现在httpd.conf文件中，但它们也可能出现在任何配置文件中。<Directory>指令不可被嵌套使用，也不能出现在<Limit>或<LimitExcept>配置段中。

参见

• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

<DirectoryMatch> 指令

<DirectoryMatch>和</DirectoryMatch>用于封装一组指令。与<Directory>类似，此指令将仅作用于指定名字的目录及其子目录。然而，它可以接受一个正则表达式作为参数。比如说：

将匹配"/www/"下所有由3个数字组成的目录。

参见

• <Directory> 获取如何在普通的<Directory>中使用正则表达式的描述。
• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

DocumentRoot 指令

此指令设置了httpd伺服的目录。在没有使用类似Alias这样的指令的情况下，服务器会将请求中的URL附加到DocumentRoot后面以构成指向文档的路径。比如说：

于是对于http://www.my.host.com/index.html 的访问就会指向/usr/web/index.html

指定DocumentRoot时不应包括最后的"/"。

参见

• 将URL映射到文件系统的位置

EnableMMAP 指令

此指令控制着httpd在递送中如果需要读取一个文件的内容，它是否可以使用内存映射。当处理一个需要访问在一个文件中的数据的请求时，比如说当递送一个使用mod_include指令进行服务器端分析的文件时，如果操作系统支持，Apache将默认使用内存映射。

这种内存映射有时会带来性能的提高，但在某些情况下，您可能会需要禁用内存映射以避免一些操作系统的问题：

• 在一些多处理器的系统上，内存映射会减低一些httpd的性能。
• 在一个挂载了NFS的DocumentRoot上，当httpd已经将一个文件进行了内存映射的情况下，删除或截断了这个文件会造成httpd因为分段故障而崩溃。

在可能遇到这些问题的服务器配置过程中，您应当使用下面这样的命令来禁用内存映射：

对于NFS的挂载文件夹，可以单独指定禁用内存映射：

EnableSendfile 指令

这个指令控制httpd是否可以使用操作系统内核的sendfile支持来将文件发送到客户端。默认情况下，当处理一个请求并不需要访问文件内部的数据时(比如发送一个静态的文件内容)，如果操作系统支持，Apache将使用sendfile将文件内容直接发送到客户端而并不读取文件。

这个sendfile机制避免了分开的读和写操作以及缓冲区分配，但是在一些平台或者一些文件系统上，最好禁止这个特性来避免一些问题：

• 一些平台可能会有构建系统检测不到的有缺陷的sendfile支持，特别是将在其他平台上使用交叉编译得到的二进制文件运行于当前对sendfile支持有缺陷的平台。
• 在Linux上启用IPv6时，使用sendfile将会触发某些网卡上的TCP-checksum offloading bugs。
• 对于一个通过网络挂载了NFS文件系统的DocumentRoot (比如：NFS或SMB)，内核可能无法可靠的通过自己的cache服务于网络文件。

如果出现以上情况，你应当使用"EnableSendfile off"来禁用sendfile：

针对NFS或SMB，这个指令可以被针对目录的设置覆盖：

ErrorDocument 指令

当遇到问题或错误的时候，Apache能被配置为进行以下四种处理之一：

1. 输出一个简单生硬的错误代码信息
2. 输出一个经过定制的信息
3. 转向一个本地的URL来处理这个问题(错误)
4. 转向一个外部的URL来处理这个问题(错误)

默认会采取第一种方法，而第2－4种方法可以使用ErrorDocument指令后面跟随一个HTTP应答代码和一个URL或信息来进行配置。Apache有时会额外提供一些信息来描述所发生的问题/错误。

URL可以由一个斜杠(/)开头来指示一个本地的URL，或是提供一个能被客户端解释的完整的URL。此外还能提供一个可以被浏览器显示的消息。比如说：

另外，特殊的"default"值可以被用来指定使用Apache内置的、简单的硬编码消息。当不需要这个定制特性的时候，可以用default恢复Apache内置的、简单的硬编码消息，否则将继承一个已有的ErrorDocument

请注意，如果您为ErrorDocument指定了一个外部的URL(比如说，任何在开头指示了类似"http"这样的访问方法的字串)，Apache将会向客户端发送一个转向指令来告诉它在哪里找到这个文档，哪怕这个文档最后还是在这个服务器上。这里面包含着一些暗示：最重要的就是客户端无法接收到一个原始的错误状态代码，取而代之的是一个转向状态代码。这将会使一些用状态代码来判断一个URL是否有效的web机器人或其它客户端产生误解。另外，如果您在"ErrorDocument 401"中使用了外部URL，客户端将不会提示用户输入密码，因为它根本没收到这样一个401的状态代码。所以，如果您想使用"ErrorDocument 401"指令，就必须指向一个本地的文档。

Microsoft Internet Explorer (MSIE)在服务器端产生的错误信息"很小"的时候会忽略它们而用自己的"友好的"错误信息进行取代。这个大小的阈值根据错误类型而不同。但一般来说，如果您使您的错误文档的大小在512 byte以上，MSIE就会显示这些服务器端产生的错误文档而不会屏蔽它们。您可以在微软知识库的文章Q294807中获取更多信息。

在2.0版以前，信息前面会加以单个的双引号字符。

参见

• 定制个性化应答文档

ErrorLog 指令

ErrorLog指令指定了当服务器遇到错误时记录错误日志的文件名。如果file-path没有以一个斜杠(/)开头，那么它将会指定一个相对与ServerRoot的路径。

如果file-path路径以一个管道(|)开头，那么会为它指定一个命令来处理错误日志。

如果系统支持，使用"syslog"替代文件名将启用通过syslogd(8)来记载日志。默认将使用系统日志机制local7，但您可以用"syslog:facility"语法来覆盖这个设置，其中，facility的取值为syslog(1)中记载的任何一个名字。

安全提示：参阅安全提示文档获得关于为什么当您记录日志文件的目录对于启动服务器以外的用户是可写的会对您的服务器构成安全威胁。

参见

• LogLevel
• Apache日志文件

FileETag 指令

FileETag指令配置了当文档是基于一个文件时用以创建Etag(实体标签)应答头域的文件的属性。(ETag的值用于进行缓冲管理以节约网络带宽。)在Apache1.3.22及以前，ETag的值总是由文件的索引节，大小和最后修改时间(mtime)决定。FileETag指令可以让您选择(如果您想进行选择)这其中哪些要素将被使用。主要关键字如下：

INode

文件的索引节点数

MTime

文件的最后修改日期及时间

Size

文件的字节数

All

所有存在的域，等价于：

FileETag INode MTime Size

None

如果一个文档是基于文件的，则不在应答中包含任何ETag头

INode，MTime和Size关键字可以加上"+"或"-"前缀，用以改变由更上层继承下来的默认值。任何没有上述前缀的关键字将立刻完全取消继承下来的设置。

如果一个目录的配置包含了"FileETag INode MTime Size"而其一个子目录包含了"FileETag -INode"那么这个子目录的设置(并会被其下任何没有进行覆盖的子目录继承)将等价于"FileETag MTime Size"。

<Files> 指令

<Files>指令提供了基于文件名的访问控制。它相对于<Directory>和<Location>指令。它将匹配一个</Files>指令。在此配置段中定义的指令将赋予基本名称(不是完整的路径)与指定的文件名相符的对象。<Files>配置段将根据它们在配置文件中出现的顺序被处理：在<Directory>配置段和.htaccess文件被读入之后，但在<Location>配置段之前。请注意：<Files>能嵌入到<Directory>配置段中以限制它们被赋予的文件系统部分。

filename 参数应当包括一个文件名或是一个通配符字串，其中"?"匹配任何单个字符，"*"匹配任何字串序列。扩展正则表达式也同样可以在使用了"~"字符后被使用。比如：

将匹配绝大部分常见的因特网图象格式。然而在Apache1.3及其后继版本中，更推荐使用<FilesMatch>指令。

请注意与<Directory>和<Location>配置段不同的是：<Files>配置段可用于.htaccess文件当中。这将允许用户在文件和文件之间的层面上控制对它们自己文件的访问。

参见

• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

<FilesMatch> 指令

<FilesMatch>指令就像<Files>指令一样提供了针对文件名的访问控制。然而，它可以使用正则表达式。比如说：

将匹配最常见的internet图形文件格式。

参见

• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

ForceType 指令

当此指令放入.htaccess或<Directory>或<Location>或<Files>配置段时，此指令强制所有匹配的文件被当作在MIME-type指定的Content-Type来伺服。比如说，如果您有一个包含大量GIF文件的目录，可您又不想全都为它们加上".gif"扩展名的话，您可以这样做：

请注意：与DefaultType指令不同，此指令将覆盖所有的mime类型关联，包括标识文件类型的扩展名。

你可以通过使用"None"覆盖任何ForceType设置：

HostnameLookups 指令

此指令启用了DNS查询，使得主机名能被记入日志(并用REMOTE_HOST参数传递给CGI/SSI)。参数Double指定进行一次双向DNS。也就是说在一次反向查询之后，再对返回的结果进行一次正向查询。在正向查询结果中至少应该有一个ip地址与初始的地址相符。(在"tcpwrappers"中的术语是PARANOID)

不论如何设置，当您使用mod_access来控制根据主机名的访问的时候，就会执行一次双向查询。这对安全来说非常必要。请注意如果您没有设置"HostnameLookups Double"，这种双向查询的结果不是自动生成的。比如说：如果仅仅设置了"HostnameLookups On"而且请求是针对一个根据主机名做了限制的对象，不论双向查询是否失败，CGI还是会把单向查询的结果用REMOTE_HOST来传送。

默认值设置为"off"是为了那些不需要进行反向查询的站点节约网络带宽考虑的。这对最终用户也是有益的，因为这样他们就不用忍受查询造成的延迟了。高访问量的网站应该将此指令设置为"off"因为DNS查询会造成明显的时间消耗。在/support目录下的logresolve工具可以在离线的情况下对已经记入日志的IP地址进行主机名的查询。

IdentityCheck 指令

当客户端机器运行了identd或类似程序时，此指令为每个链接记录RFC1413兼容的远端用户名。这些信息将记入访问日志中。

此信息除了用于基本的跟踪以外是不应该多加信任的。

请注意因为对每个请求都会进行这样的查询，所以这样设置有可能会使您的服务器访问出现严重的延迟。当涉及到防火墙的时候，每次查询都会因为可能的失败而对每次点击增加30秒的延迟。所以一般来说对于公网上的服务器这个指令并不是很有用。

<IfDefine> 指令

<IfDefine test>...</IfDefine>配置段用于标识有条件的指令。<IfDefine>配置段中的指令仅当test结果为真时才进行处理。如果测试失败。此配置段中的指令将会被忽略。

<IfDefine>配置段中的test可以为以下两种形式之一：

• parameter-name
• !parameter-name

在第一种情况下，仅当符合parameter-name的参数已经定义的情况下才对开始和结束标记之间的指令进行处理。第二种情况则截然相反。仅当parameter-name没有定义的情况下才进行指令的处理。

parameter-name变量是在服务启动时，通过httpd命令行的"-Dparameter"这样的形式指定的。

<IfDefine>配置段是可以嵌套的，从而可以实现简单的多参数测试。比如说：

<IfModule> 指令

<IfModule test>...</IfModule>配置段用于标识根据指定模块的存在与否而决定是否进行处理的指令。在<IfModule>配置段中的指令仅当test 为真的时候才进行处理。如果测试失败，所有其间的指令都将忽略。

<IfModule>段中的test可以为以下两种方式之一：

• module name
• !module name

在第一种情况下，起始和结束标记之间的指令仅当符合module name的模块载入后才被执行。此模块可以为编译时加入静态链接模块或是使用LoadModule指令动态载入的模块。第二种情况是相反的。仅当module name没有载入时才进行指令的处理。

module name参数是在模块编译时模块的文件名。比如说：mod_rewrite.c。如果模块包含多个源代码文件，您应当使用包含STANDARD20_MODULE_STUFF的那个。

<IfModule>配置段是可以嵌套的，从而可以实现简单的多模块测试。比如说：

Include 指令

这个指令允许在服务器配置文件中加入其它配置文件。

Shell风格(fnmatch())的通配符可以用于按照字母顺序一次包含多个文件。另外，如果Include指向了一个目录而不是一个文件，Apache将读入目录及其子目录下的所有文件，并依照字母顺序将这些文件作为配置文件进行解析。但是并不推荐这么做，因为偶尔会有临时文件在这个目录中生成，从而导致httpd启动失败。

文件的路径可以是一个完整的绝对路径(比如说，以一个斜杠开头)：

或是相对于ServerRoot目录的相对路径：

请确保包含的目录中不包含任何诸如编辑器临时文件等引起误导的文件，因为Apache会尝试着读取它们并把其中的内容作为配置指令来处理，这样可能会导致启动过程的失败。运行"apachectl configtest"将会把配置检查时所使用的所有文件列出来以供参考。这将有助于检验配置中是否仅包含了您所希望出现那些文件。

参见

• apachectl

KeepAlive 指令

Keep-Alive扩展自HTTP/1.0和HTTP/1.1的持久链接特性。提供了长效的HTTP会话，用以在同一个TCP连接中进行多次请求。在某些情况下，这样的方式会对包含大量图片的HTML文档造成的延时起到50%的加速作用。在Apache1.2版本以后，您可以设置"KeepAlive On"以启用持久链接。

对于HTTP/1.0的客户端来说，仅当客户端指定使用的时候才会使用持久链接连接。此外，仅当能够预先知道传输的内容长度时，才会与HTTP/1.0的客户端建立持久链接连接。这意味着那些变长的内容，诸如CGI输出、SSI页面、以及服务器端生成的目录列表等内容一般来说将无法使用与HTTP/1.0客户端建立的持久链接连接。而对于HTTP/1.1的客户端来说，如果没有进行特殊指定，持久将是默认的连接方式。如果客户端进行了请求，将使用分块编码以解决在持久链接里发送未知长度内容的问题。

参见

• MaxKeepAliveRequests

KeepAliveTimeout 指令

Apache在关闭连接前等待下一个请求的时间间隔。一旦收到一个请求，超时值将会被设置为Timeout指令指定的值。

对于高负荷的服务器来说，KeepAliveTimeout设置为一个比较大的值会导致一些性能方面的问题：超时值越大，与空闲客户端保持连接的进程就越多。

<Limit> 指令

访问控制一般来说是对所有的访问方法都生效的，这也是我们普遍希望达到的效果。一般情况下，访问控制指令不应该放入<Limit>段中。

<Limit>指令的目的是限制访问控制的效果使其仅作用于某些HTTP方法。对于其它方法，<Limit>括号中的访问限制将不起任何作用。下例中的访问控制仅作用于POST，PUT和DELETE方法，其它方法不受任何影响：

列出的方法名可为下列的一个或多个：GET, POST, PUT, DELETE, CONNECT, OPTIONS, PATCH, PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK. 方法名是大小写敏感的。如果使用了GET 的定义，它会同时限制HEAD请求。TRACE方法不能被限制。

<LimitExcept> 指令

<LimitExcept>和</LimitExcept>用于封装一组访问控制指令，并将其作用于所有未在参数中标出的HTTP方法。也就是说，与<Limit>相反，它用于控制标准的和非标准以及无法辨识的方法。

比如：

LimitInternalRecursion 指令

例如，当使用Action指令内部重定向原始请求到一个CGI脚本时，一个内部重定向将会发生。子请求是Apache的一个用于找到如果一个URI被请求时将会发生什么的机制。例如，mod_dir使用子请求来寻找那些根据DirectoryIndex指令应当被列出的文件。

LimitInternalRecursion 可以防止服务器进入一个内部重定向或者子请求的死循环而崩溃。这样的死循环通常由错误的配置引起。

这个指令存储了两个不同的限制，这两个限制是基于每个单独的请求进行计算的。第一个number限制了内部重定向链的最大长度(一个接一个)。第二个number限制了子请求最大嵌套层数。如果你只指定了一个number，那么将会被同时应用于两个限制。

LimitRequestBody 指令

此指令在0(意味着无限制)到2147483647(2GB)间限制了请求体所允许的字节数。

LimitRequestBody可以让用户在其作用范围内(整个服务器、特定目录、特定文件或特定位置)设置一个允许客户端发送的HTTP请求体的最大字节长度的限制。如果客户端的请求超出了这个限制，服务器会回应一个错误而不是伺服这个请求。一个普通请求的信息体在很大程度上取决于资源的自然属性和这个资源允许的方法。CGI脚本经常用消息体把表单的信息传递给服务器。使用PUT方法至少会需要与服务器期望从这个资源得到的信息量差不多大小的值。

此指令给了服务器管理员更大的可控性以控制客户端不正常的请求行为。这有助于避免某些形式的拒绝服务攻击。

比如，如果您允许文件上传到某个位置，而且希望能将上传文件的大小设置为100K，您可以使用下面的指令：

LimitRequestFields 指令

Number 是一个0(意味着不限)到32767之间的整数。默认值为编译时的常量DEFAULT_LIMIT_REQUEST_FIELDS (发布值为100)。

LimitRequestFields指令允许服务器管理员修改在一个HTTP请求中的请求头域的数量限制。服务器需要此值大于一个普通客户端请求中包含头域的数量。一个客户端请求头域的数量很少大于20，但根据客户端的不同这个数字有很大的差别，经常取决于用户配置他们的浏览器扩展以支持更详细的内容协商。可选的HTTP扩展经常使用请求头域来实现。

这个指令给了服务器管理员更大的可控性以控制客户端不正常的请求行为。这有助于避免某些形式的拒绝服务攻击。如果正常使用的客户端得到了服务器的错误应答，指出其在请求中发送了过多的头域，您应该适当的增大此值。

举例如下：

LimitRequestFieldSize 指令

这个指令指定了HTTP请求头允许的大小。bytes的取值范围为0到编译时常量DEFAULT_LIMIT_REQUEST_FIELDSIZE(发布值为8190 )之间。

LimitRequestFieldSize指令允许服务器管理员在服务器编译时设定的输入缓冲大小的范围之下降低关于HTTP请求头域大小的限制。一般来说，服务器需要此值足够大，以适应普通客户端的任何请求的头域大小。一个普通头域的大小对于不同的客户端来说是有着很大差别的，一般与用户配置他们的浏览器以支持更多的内容协议密切相关。

这个指令给了服务器管理员更大的可控性以控制客户端不正常的请求行为。这有助于避免某些形式的拒绝服务攻击。

举例如下：

LimitRequestLine 指令

这个指令将设置HTTP请求行的字节数限制。bytes的范围在0到编译时常量DEFAULT_LIMIT_REQUEST_LINE(发布值为8190)之间。

LimitRequestLine指令允许服务器管理员在服务器编译时设定的输入缓冲大小的范围之下降低客户端HTTP请求行允许大小的限制。因为请求行包括HTTP方法、URI和协议版本，所以LimitRequestLine指令会限制请求URI的长度。服务器会需要这个值足够大以装载它所有的资源名，包括可能在GET请求中所传递的查询部分的所有信息。

这个指令给了服务器管理员更大的可控性以控制客户端不正常的请求行为。这有助于避免某些形式的拒绝服务攻击。

举例如下：

LimitXMLRequestBody 指令

限制基于XML的请求体大小的最大值(以字节为单位)，0将禁用这一检查。

比如：

<Location> 指令

<Location>提供了基于URL的访问控制。与<Directory>指令类似，它也会启用一个以</Location>结尾的配置段。<Location>配置段的处理位于<Directory>配置段、.htaccess文件、<Files>配置段之后，并依照在配置文件中出现的顺序进行处理。

<Location>配置段完全在在文件系统之外操作。这有几个重要的后果。最重要的是<Location>不能用于针对文件系统的访问控制。因为可能会有几个不同的URL指向文件系统中的同一个文件，所以这样的控制常常会被很容易的绕过。

对所有的原始(非代理)请求来说，匹配的URL应该是具有"/path/"形式的URL路径。不包括访问方法、主机名、端口或查询字串等。对于代理的请求，匹配的URL必须为"scheme://servername/path"的形式，而且必须包括前缀。

URL可以用一个通配符字串来进行通配符的处理。"?"匹配任何单个的字符，而"*"匹配所有字符序列。

也可以使用扩展的正则表达式，附加"~"字符来进行说明。例如：

将匹配所有包含字串"/extra/data"或"/special/data"的URL。在Apache1.3及其后续版本中，加入了一个新的推荐使用的<LocationMatch>指令，其功能与<Location>的正则表达式版本相同。

<Location>的功能在与SetHandler指令联用时能发挥最大效能。比如启用状态请求，但仅对foo.com的浏览器起效，您可以这样使用：

参见

• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

<LocationMatch> 指令

<LocationMatch>与<Location>指令相同，提供了基于URL的访问控制。但它使用正则表达式作为参数，而不是简单字符串。比如：

将匹配包含子串"/extra/data"或"/special/data"的URL。

参见

• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。

LogLevel 指令

LogLevel用于调整记录在错误日志中的信息的详细程度。(参见ErrorLog指令)。可以选择下列级别，依照重要性降序排列：

当指定了特定级别时，所有级别高于它的信息也会同时报告。比如，当指定了"LogLevel info"时，所有notice和warn级别的信息也会被记录。

建议至少要使用crit级别。

示例如下：

MaxKeepAliveRequests 指令

MaxKeepAliveRequests指令限制了当启用KeepAlive时，每个连接允许的请求数量。如果将此值设为"0"，将不限制请求的数目。我们建议最好将此值设为一个比较大的值，以确保最优的服务器性能。

示例如下：

NameVirtualHost 指令

如果您要配置基于域名的虚拟主机，NameVirtualHost指令就是您必须的指令之一。

尽管addr参数可以使用主机名，但建议您还是使用IP地址。比如：

使用NameVirtualHost指令，您可以指定一个基于域名的虚拟主机将使用哪个IP地址来接受请求。在一个防火墙或是其它代理接受了请求并把它转到服务器所在的另外一个IP地址上的情况下，您必须指定伺服请求的机器物理界面上的IP地址。如果您对于多个地址使用了多个基于域名的虚拟主机，您应该为每个地址使用这个指令。

另外，您还可以为您使用的基于域名的虚拟主机指定一个端口号。比如：

IPv6地址必须封装在一对方括号内，如下例所示：

为了接受所有界面的请求，您可以使用参数"*"

参见

• 虚拟主机文档

Options 指令

Options指令控制了在特定目录中将使用哪些服务器特性。

option 可以设置为None，在这种情况下，将不启用任何额外特性。或设置为以下选项中的一个或多个：

All

除MultiViews之外的所有特性。这是默认设置。

ExecCGI

允许使用mod_cgi执行CGI脚本。

FollowSymLinks

服务器会在此目录中使用符号连接。

注意：即使服务器会使用符号连接，但它不会改变用于匹配<Directory>配置段的路径名。

注意：如果此配置位于<Location>配置段中，则此设置会被忽略。

Includes

允许mod_include提供的服务器端包含。

IncludesNOEXEC

允许服务器端包含，但禁用"#exec cmd"和"#exec cgi"。但仍可以从ScriptAlias目录使用"#include virtual"虚拟CGI脚本。

Indexes

如果一个映射到目录的URL被请求，而此目录中又没有DirectoryIndex(例如：index.html)，那么服务器会返回由mod_autoindex生成的一个格式化后的目录列表。

MultiViews

允许使用mod_negotiation提供的内容协商的"多重视图"。

SymLinksIfOwnerMatch

服务器仅在符号连接与其目的目录或文件的拥有者具有相同的uid时才使用它。

注意：如果此配置出现在<Location>配置段中，此选项将被忽略。

一般来说，如果一个目录被多次设置了Options，则最特殊的一个会被完全接受，而各个可选项的设定彼此并不融合(参见配置段的合并)。然而，如果所有作用于Options指令的可选项前都加有"+"或"-"符号，此可选项将被合并。所有前面加有"+"号的可选项将强制覆盖当前可选项设置，而所有前面有"-"号的可选项将强制从当前可选项设置中去除。

比如，没有任何"+"和"-"符号：

则只有Includes设置到"/web/docs/spec"目录上。然而如果第二个Options指令使用了"+"和"-"符号：

么就会有FollowSymLinks和Includes设置到"/web/docs/spec"目录上。

没有其它设置时，默认设置为"All"

Require 指令

这个指令选择那个认证用户能访问一个资源。其语法如下：

Require user userid [userid] ...

只有指定的用户可以访问此目录。

Require group group-name [group-name] ...

只有隶属于指定用户组的用户可以访问此目录。

Require valid-user

所有有效用户都可以访问此目录。

Require必须伴随AuthName和AuthType指令，以及诸如AuthUserFile和AuthGroupFile(用以定义用户和用户组)以确保其能够正确工作。例如：

使用这种方法提供的访问控制对所有方法都有效。这是一般情况下期望达到的效果。如果您仅希望对某个特定的方法加以限制，而不涉及其它方法时，您可以将Require语句放入<Limit>配置段中。

参见

• Satisfy
• mod_access

RLimitCPU 指令

使用一个或两个参数。第一个参数设置了所有进程的软资源限制，第二个参数设置了最大资源限制。两个参数均可设置为一个数值或是"max"以表示设置为操作系统允许的最大值。增大此资源限制最大值需要以root运行服务器或是在初始化启动语句中进行设置。

这个限制将作用于Apache子进程服务的请求所衍生出的进程，而不是Apache子进程本身。这个范围包括CGI脚本和SSI执行命令，但不包括所有从Apache父进程衍生出的进程。比如管道日志。

CPU资源限制表示为每进程占用的秒数。

参见

• RLimitMEM
• RLimitNPROC

RLimitMEM 指令

使用一个或两个参数。第一个参数设置了所有进程的软资源限制，第二个参数设置了最大资源限制。两个参数均可设置为一个数值或是"max"以表示设置为操作系统允许的最大值。增大此资源限制最大值需要以root运行服务器或是在初始化启动语句中进行设置。

这个限制将作用于Apache子进程服务的请求所衍生出的进程，而不是Apache子进程本身。这个范围包括CGI脚本和SSI执行命令，但不包括所有从Apache父进程衍生出的进程。比如管道日志。

内存资源限制表示为每进程占用的字节数。

参见

• RLimitCPU
• RLimitNPROC

RLimitNPROC 指令

使用一个或两个参数。第一个参数设置了所有进程的软资源限制，第二个参数设置了最大资源限制。两个参数均可设置为一个数值或是"max"以表示设置为操作系统允许的最大值。增大此资源限制最大值需要以root运行服务器或是在初始化启动语句中进行设置。

这个限制将作用于Apache子进程服务的请求所衍生出的进程，而不是Apache子进程本身。这个范围包括CGI脚本和SSI执行命令，但不包括所有从Apache父进程衍生出的进程。比如管道日志。

进程限制控制了每个用户的进程数。

参见

• RLimitMEM
• RLimitCPU

Satisfy 指令

同时使用Allow和Require时的访问策略。参数可以设置为"All"或"Any"。这个指令仅在某个特定区域的访问控制同时被用户名/密码、客户端主机地址进行限定的时候起作用。默认行为("All")采取客户端首先通过地址访问限制并输入有效的用户名和密码的方式。使用可选项"Any"将使客户端在通过主机限制或是输入一个有效的用户名和密码两种方式之一得到访问权限。这样，就可以通过密码来限制一个区域的访问，但允许某些特定地址的客户端访问时不需要输入密码。

比如，如果您想让您局域网内的用户访问您的web网站时不受限制，但局域网外的用户需提供密码才能进行访问，您可以采取类似如下的配置：

从2.0.51版本开始，Satisfy指令可以被限定于由<Limit>和<LimitExcept>配置段指定的特定的方法。

参见

• Allow
• Require

ScriptInterpreterSource 指令

这个指令用于控制Apache如何找到运行CGI脚本的解释器。默认设置是"Script"，使用在脚本中以"#!"行指定的解释器。在Win32上这一行通常看上去像：

或者，如果perl的位置已经在PATH中指定，则可以简单的写成：

设置为"ScriptInterpreterSource Registry"将使用脚本文件扩展名(比如.pl)作为搜索项对Windows注册表项"HKEY_CLASSES_ROOT"进行搜索。 这个命令由注册表子键"Shell\ExecCGI\Command"或"Shell\Open\Command"定义(如果前者不存在)。如果无法找到该注册表项，Apache将采用默认值"Script"。

"Registry-Strict"选项和"Registry"差不多，但是只使用"Shell\ExecCGI\Command"子键。"ExecCGI"键不是一个普通的键。它必须在注册表中手动配置，从而可以防止意外的程序调用。

ServerAdmin 指令

ServerAdmin设置了在所有返回给客户端的错误信息中包含的管理员邮件地址。

您为这个目的专门设置一个邮箱是值得的比如：

因为用户一般不会注意到他们在讨论服务器的问题！

ServerAlias 指令

ServerAlias指令与基于域名的虚拟主机联用，设定主机的别名。

参见

• Apache虚拟主机文档

ServerName 指令

ServerName指令设置了服务器用于辨识自己的主机名和端口号。这主要用于创建重定向URL。比如，一个放置web服务器的主机名为simple.example.com，但同时有一个DNS别名www.example.com。而您希望web服务器更显著一点，您可以使用如下的指令：

当没有指定ServerName时，服务器会尝试对IP地址进行反向查询来推断主机名。如果在ServerName中没有指定端口号，服务器会使用接受请求的那个端口。为了加强可靠性和可预测性，您应该使用ServerName显式的指定一个主机名和端口号。

如果您正在使用基于域名的虚拟主机，在<VirtualHost>配置段中的ServerName将指定为为了匹配这个虚拟主机，在请求的"Host:"头中必须出现的主机名。

请参见UseCanonicalName指令以获得关于自引用(self-referential)URL(比如使用mod_dir模块)是需要指定一个特定端口，还是使用客户端请求的端口号的更详细的信息。

参见

• 关于DNS和Apache
• Apache虚拟主机文档
• UseCanonicalName
• NameVirtualHost
• ServerAlias

ServerPath 指令

ServerPath指令为主机设置了保守的(legacy)URL路径名，用于和基于域名的虚拟主机配合使用。

参见

• Apache虚拟主机文档

ServerRoot 指令

ServerRoot指令设置了服务器存在的目录。一般来说它将包含"conf"和"logs"子目录。其它配置文件的相对路径即基于此目录 (比如：Include或LoadModule)。

参见

• httpd的"-d"选项
• 安全提示中关于如何正确设置ServerRoot权限的部分

ServerSignature 指令

ServerSignature指令允许您配置服务器端生成文档的页脚(错误信息、mod_proxy的ftp目录列表、mod_info的输出)。您启用这个页脚的原因主要在于处于一个代理服务器链中的时候，用户基本无法辨识出究竟是链中的哪个服务器真正产生了返回的错误信息。

默认的"Off"设置没有错误行(这样便与Apache1.2及更旧版本兼容)。采用"On"会简单的增加一行关于服务器版本和正在伺服的虚拟主机的ServerName，而"EMail"设置会如文档中说明的那样额外创建一个指向ServerAdmin的"mailto:"部分。

对于2.0.44以后的版本，显示的详细服务器版本号将由ServerTokens指令控制。

参见

• ServerTokens

ServerTokens 指令

这个指令控制了服务器回应给客户端的应答头是否包含关于服务器操作系统类型和编译进的模块描述信息。

ServerTokens Prod[uctOnly]

服务器会发送(比如)：Server: Apache

ServerTokens Major

服务器会发送(比如)：Server: Apache/2

ServerTokens Minor

服务器会发送(比如)：Server: Apache/2.0

ServerTokens Min[imal]

服务器会发送(比如)：Server: Apache/2.0.41

ServerTokens OS

服务器会发送(比如)：Server: Apache/2.0.41 (Unix)

ServerTokens Full (或未指定)

服务器会发送(比如)：Server: Apache/2.0.41 (Unix) PHP/4.2.2 MyMod/1.2

此设置将作用于整个服务器，而且不能用在虚拟主机的配置段中。

2.0.44版本以后，这个指令还控制着ServerSignature指令的显示内容。

参见

• ServerSignature

SetHandler 指令

当这个指令放入.htaccess或<Directory>或<Location>配置段中时，这个指令将强制所有匹配的文件通过handler-name指定的处理器处理。比如：如果有一个目录，您想不管其中的文件有怎么样的扩展名，都将它作为图像映射规则文件来解析，您可以将下例放入那个目录的.htaccess中：

再来一个例子：如果您想当http://servername/status被请求时，服务器显示一个状态报告，您可以将下面的语句放入httpd.conf里面：

你可以通过使用"None"来改写一个早先定义的SetHandler指令。

参见

• AddHandler

SetInputFilter 指令

SetInputFilter指令为服务器接受并处理客户端请求和POST输入设置了过滤器。这是在其它地方(包括AddInputFilter指令)设置的过滤器的以外附加的过滤器。

如果设置了多于一个的过滤器，它们必须按照处理内容的顺序用分号(;)分隔。

参见

• 过滤器文档

SetOutputFilter 指令

SetOutputFilter指令设置了用于在服务器应答发送到客户端之前使用的过滤器。这是在其它地方(包括AddInputFilter指令)设置的过滤器的以外附加的过滤器。

例如：下述配置将会把"/www/data/"目录下的所有文件作为SSI文件来处理。

如果设置了多于一个的过滤器，它们必须按照处理内容的顺序用分号(;)分隔。

参见

• 过滤器文档

TimeOut 指令

TimeOut指令用于设置Apache等待以下三种事件的时间长度：

1. 接受一个GET请求耗费的总时间。
2. POST或PUT请求时，接受两个TCP包之间的时间。
3. 应答时TCP包传输中两个ACK包之间的时间。

我们计划在发展里程中，逐步把它们分别变得更易配置。计时器在1.2版本之前的默认值为1200，而现在已经设置为300了，但对于绝大多数情况来说仍是足够的。没有把它默认值设的更小的原因在于代码里还有点问题：有时发送一个包之后，计时器没有复位。

UseCanonicalName 指令

在很多情况下，Apache必须构建一个自引用URL(即一个指回相同服务器的URL)。使用"UseCanonicalName On"将会使用ServerName这个域名将用于所有的自引用URL、SERVER_NAME、CGI中的SERVER_PORT 。

设置为"UseCanonicalName Off"时，如果客户端提供了相关信息(否则，将如上所述使用标准域名)，Apache将会使用这些信息来构建自引用URL。这些值与基于域名的虚拟主机对于同样的客户端实现的相同。CGI变量SERVER_NAME和SERVER_PORT也会由客户端提供的值来构建。

用这样的方式成功解决问题的例子如下：在一个局域网内，您想让连接主机的用户使用诸如"www"这样的短域名进行访问。您会注意到，如果用户键入了类似"http://www/splat"这样的一个短域名和一个目录的URL，而没有最后的斜线，Apache会将他们转向到"http://www.domain.com/splat/"。如果您在这个目录上启用了身份验证，这会导致用户必须进行两次验证：一次针对"www"而另外一次针对"www.domain.com"(参见关于此主题的FAQ获得更多信息)。但如果UseCanonicalName设为"Off"，Apache就会转向到"http://www/splat/"。

第三个可选项是"UseCanonicalName DNS"，用于为大量基于IP的虚拟主机支持那些老旧的不提供"Host:"头的浏览器使用。使用这个选项时，Apache将对客户端连入的服务器的IP地址进行反向DNS查询，以构建自引用URL。

参见

• ServerName
• Listen

<VirtualHost> 指令

<VirtualHost>和</VirtualHost>用于封装一组仅作用于特定虚拟主机的指令。任何在虚拟主机配置中可以使用的指令也同样可以在这里使用。当服务器接受了一个特定虚拟主机的文档请求时，它会使用封装在<VirtualHost>配置段中的指令。Addr 可以是：

• 虚拟主机的IP地址
• 虚拟主机IP地址对应的完整域名
• 字符"*"，仅与"NameVirtualHost *"配合使用以匹配所有的IP地址
• 字符串"_default_"，与基于IP的虚拟主机联用以捕获所有没有匹配的IP地址。

IPv6的地址必须放入方括号中指定，否则作为可选项的端口号将无法确定。一个IPv6的示例如下：

每个虚拟主机必须对应不同的IP地址、端口号或是不同的主机名。在第一种情况下，服务器所在的物理机器必须配置为可以为多个IP地址接受IP包。(在机器没有多个网络硬件界面的情况下，如果您的操作系统支持，您可以使用"ifconfig alias"命令来达到这个目的)。

当使用基于IP的虚拟主机时，特殊的名称"_default_"可以在没有匹配到其它列出的虚拟主机的情况下作为匹配任何IP地址的默认虚拟主机。在没有进行"_default_"虚拟主机的设定时，在没有IP与请求匹配的情况下，将使用"主服务器"(在所有虚拟主机配置段之外)的配置。但请注意：任何匹配NameVirtualHost指令的IP地址既不会使用"主服务器"配置，也不会使用"_default_"虚拟主机的配置。参见基于域名的虚拟主机文档获得更多详情。

您可以指定一个":port"来改变匹配的端口。如果没有指定，它将沿用主服务器中离它最近的那个Listen指定的值。您也可以指定":*"来匹配那个地址上的所有端口(当您使用_default_时，这是推荐采用的方法)。

参见

• Apache虚拟主机文档
• 关于DNS和Apache的警告
• 设置Apache使用的地址和端口
• <Directory>, <Location> 和 <Files> 配置段是如何工作的中包含了当接受一个请求时，这些不同的配置段是如何组合工作的相关解释。