Apache 模块 mod_mime

AddCharset 指令

AddCharset 指令将给定的文件名扩展名映射到指定的字符集（给定字符编码的互联网注册名称）。charset 是 媒体类型的字符集参数，用于文件名包含 extension 的资源。此映射将添加到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。

AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis

然后，文档 xxxx.ja.jis 将被视为一个字符集为 ISO-2022-JP 的日语文档（文档 xxxx.jis.ja 也是如此）。AddCharset 指令对于告知客户端文档的字符编码以便文档能够被正确解释和显示，以及用于 内容协商 非常有用，在内容协商中，服务器根据客户端的字符集首选项从多个文档中返回一个文档。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

另请参阅

• mod_negotiation
• AddDefaultCharset

AddEncoding 指令

AddEncoding 指令将给定的文件名扩展名映射到指定的 HTTP 内容编码。encoding 是 HTTP 内容编码，用于将 Content-Encoding 头部字段的值附加到以 extension 命名的文档。此映射将添加到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。

AddEncoding x-gzip .gz
AddEncoding x-compress .Z

这将导致包含 .gz 扩展名的文件名被标记为使用 x-gzip 编码进行编码，而包含 .Z 扩展名的文件名被标记为使用 x-compress 进行编码。

旧的客户端期望 x-gzip 和 x-compress，但是标准规定它们分别等效于 gzip 和 compress。Apache 通过忽略任何前导 x- 来进行内容编码比较。当响应编码时，Apache 将使用客户端请求的任何形式（例如，x-foo 或 foo）。如果客户端没有专门请求特定形式，Apache 将使用 AddEncoding 指令给出的形式。简而言之，对于这两个特定的编码，您应该始终使用 x-gzip 和 x-compress。对于更新的编码，例如 deflate，应该在没有 x- 的情况下指定。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

AddHandler 指令

具有 extension 名称的文件将由指定的 handler-name 提供服务。此映射将添加到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。例如，要激活具有 .cgi 文件扩展名的 CGI 脚本，您可以使用

AddHandler cgi-script .cgi

一旦将其放入您的 httpd.conf 文件中，任何包含 .cgi 扩展名的文件都将被视为 CGI 程序。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

另请参阅

• SetHandler

AddInputFilter 指令

AddInputFilter 将文件名扩展名 extension 映射到 过滤器，这些过滤器将在客户端请求和 POST 输入被服务器接收时处理它们。这将添加到在其他地方定义的任何过滤器中，包括 SetInputFilter 指令。此映射将合并到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。

如果指定了多个 filter，则必须用分号分隔它们，并按它们应该处理内容的顺序排列。filter 不区分大小写。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

另请参阅

• RemoveInputFilter
• SetInputFilter

AddLanguage 指令

AddLanguage 指令将给定的文件名扩展名映射到指定的语言。具有文件名 extension 的文件被分配一个 HTTP Content-Language 值 language-tag，该值对应于 RFC 3066 定义的语言标识符。此指令将覆盖对相同 extension 已存在的任何映射。

AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr

然后，文档 xxxx.en.Z 将被视为一个压缩的英语文档（文档 xxxx.Z.en 也是如此）。尽管语言被报告给客户端，但浏览器不太可能使用此信息。AddLanguage 指令对于 内容协商 更有用，在内容协商中，服务器根据客户端的语言首选项从多个文档中返回一个文档。

如果对同一个扩展名进行了多个语言分配，则遇到的最后一个分配将是使用的分配。也就是说，对于

AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en

具有 .en 扩展名的文档将被视为 en-us。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

另请参阅

• mod_negotiation

AddOutputFilter 指令

AddOutputFilter 指令将文件名扩展名 extension 映射到 过滤器，这些过滤器将在服务器响应被发送到客户端之前处理它们。这将添加到在其他地方定义的任何过滤器中，包括 SetOutputFilter 和 AddOutputFilterByType 指令。此映射将合并到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。

例如，以下配置将处理所有 .shtml 文件以进行服务器端包含，然后使用 mod_deflate 压缩输出。

AddOutputFilter INCLUDES;DEFLATE shtml

如果指定了多个过滤器，则必须用分号分隔它们，并按它们应该处理内容的顺序排列。filter 参数不区分大小写。

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

请注意，当使用 AddOutputFilter 指令定义一组过滤器时，所做的任何定义都将替换 AddOutputFilter 指令先前做出的任何定义。

# Effective filter "DEFLATE"
AddOutputFilter DEFLATE shtml
<Location "/foo">
  # Effective filter "INCLUDES", replacing "DEFLATE"
  AddOutputFilter INCLUDES shtml
</Location>
<Location "/bar">
  # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE"
  AddOutputFilter INCLUDES;DEFLATE shtml
</Location>
<Location "/bar/baz">
  # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE"
  AddOutputFilter BUFFER shtml
</Location>
<Location "/bar/baz/buz">
  # No effective filter, replacing "BUFFER"
  RemoveOutputFilter shtml
</Location>

另请参阅

• RemoveOutputFilter
• SetOutputFilter

AddType 指令

AddType 指令将给定的文件名扩展名映射到指定的媒体类型。media-type 是用于文件名包含 extension 的媒体类型。此映射将添加到任何已生效的映射中，覆盖对相同 extension 已存在的任何映射。

AddType image/gif .gif

或者，在一个指令中指定多个文件扩展名

AddType image/jpeg jpeg jpg jpe

extension 参数不区分大小写，可以带或不带前导点。文件名可能具有 多个扩展名，并且 extension 参数将与每个扩展名进行比较。

可以使用 qs 限定 media-type 来实现与 mod_negotiation 的 LanguagePriority 相似的效果

AddType application/rss+xml;qs=0.8 .xml

这在某些情况下很有用，例如，当请求 Accept: */* 的客户端实际上无法处理服务器返回的内容时。

此指令主要配置为从文件系统中提供服务的静态文件生成的媒体类型。对于除静态文件以外的资源，响应生成器通常会指定一个 Content-Type，此指令无效。

另请参阅

• ForceType
• mod_negotiation

DefaultLanguage 指令

DefaultLanguage 指令告诉 Apache，指令作用域内的所有资源（例如，当前 <Directory> 容器覆盖的所有资源），如果没有任何显式语言扩展名（如 .fr 或 .de，如 AddLanguage 配置），则应分配一个 Content-Language 为 language-tag。例如，这允许将整个目录树标记为包含荷兰语内容，而无需重命名每个文件。请注意，与使用扩展名指定语言不同，DefaultLanguage 只能指定一种语言。

如果没有任何 DefaultLanguage 指令生效，并且文件没有 AddLanguage 配置的任何语言扩展名，则不会生成 Content-Language 头部字段。

DefaultLanguage en

另请参阅

• mod_negotiation

ModMimeUsePathInfo 指令

ModMimeUsePathInfo 指令用于将文件名与 path_info URL 组件组合起来，以将 mod_mime 的指令应用于请求。默认值为 Off - 因此，path_info 组件将被忽略。

当您拥有虚拟文件系统时，建议使用此指令。

ModMimeUsePathInfo On

如果您请求的是 /index.php/foo.shtml，mod_mime 将会把这个请求当作 /index.php/foo.shtml 处理，并且类似于 AddOutputFilter INCLUDES .shtml 这样的指令会将 INCLUDES 过滤器添加到这个请求中。如果 ModMimeUsePathInfo 没有设置，INCLUDES 过滤器将不会被添加。对于虚拟路径，例如由 <Location> 定义的路径，也会以类似的方式工作。

另请参阅

• AcceptPathInfo

MultiviewsMatch 指令

MultiviewsMatch 指令允许 mod_negotiation 模块的 Multiviews 功能有三种不同的行为。Multiviews 允许对一个文件（例如 index.html）的请求匹配任何与基本请求相匹配的协商扩展名，例如 index.html.en、index.html.fr 或 index.html.gz。

NegotiatedOnly 选项规定，基本名称后面的每个扩展名都必须与 mod_mime 识别的用于内容协商的扩展名相对应，例如字符集、内容类型、语言或编码。这是最严格的实现方式，副作用最少，也是默认行为。

要包含与处理器和/或过滤器关联的扩展名，请将 MultiviewsMatch 指令设置为 Handlers、Filters 或两者。如果所有其他因素都相同，则将提供最小的文件，例如，在 index.html.cgi（500 字节）和 index.html.pl（1000 字节）之间进行选择时，.cgi 文件将在此示例中获胜。.asis 文件的用户可能更喜欢使用处理器选项，如果 .asis 文件与 asis-handler 相关联。

您最终可以允许任何扩展名匹配，即使 mod_mime 无法识别该扩展名。这可能会导致不可预测的结果，例如提供网站管理员从未期望提供的 .old 或 .bak 文件。

例如，以下配置将允许处理器和过滤器参与 Multviews，但将排除未知文件

MultiviewsMatch Handlers Filters

MultiviewsMatch 不允许在 <Location> 或 <LocationMatch> 部分中使用。

另请参阅

• 选项
• mod_negotiation

RemoveCharset 指令

RemoveCharset 指令会删除具有给定扩展名的文件的任何字符集关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。

extension 参数不区分大小写，可以带或不带前导点指定。

RemoveCharset .html .shtml

RemoveEncoding 指令

RemoveEncoding 指令会删除具有给定扩展名的文件的任何编码关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。它的一个使用示例可能是

AddEncoding x-gzip .gz
AddType text/plain .asc
<Files "*.gz.asc">
    RemoveEncoding .gz
</Files>

这将导致 foo.gz 被标记为使用 gzip 方法进行编码，而 foo.gz.asc 被标记为未编码的纯文本文件。

extension 参数不区分大小写，可以带或不带前导点指定。

RemoveHandler 指令

RemoveHandler 指令会删除具有给定扩展名的文件的任何处理器关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。它的一个使用示例可能是

AddHandler server-parsed .html

RemoveHandler .html

这将使 /foo/bar 目录中的 .html 文件被视为普通文件，而不是被视为解析的候选文件（参见 mod_include 模块）。

extension 参数不区分大小写，可以带或不带前导点指定。

RemoveInputFilter 指令

RemoveInputFilter 指令会删除具有给定扩展名的文件的任何输入 过滤器 关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。

extension 参数不区分大小写，可以带或不带前导点指定。

另请参阅

• AddInputFilter
• SetInputFilter

RemoveLanguage 指令

RemoveLanguage 指令会删除具有给定扩展名的文件的任何语言关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。

extension 参数不区分大小写，可以带或不带前导点指定。

RemoveOutputFilter 指令

RemoveOutputFilter 指令会删除具有给定扩展名的文件的任何输出 过滤器 关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。

extension 参数不区分大小写，可以带或不带前导点指定。

RemoveOutputFilter shtml

另请参阅

• AddOutputFilter

RemoveType 指令

RemoveType 指令会删除具有给定扩展名的文件的任何 媒体类型 关联。这允许子目录中的 .htaccess 文件撤消从父目录或服务器配置文件继承的任何关联。它的一个使用示例可能是

RemoveType .cgi

这将删除 /foo/ 目录及其下所有目录中对 .cgi 文件的任何特殊处理，导致包含这些文件的响应省略 HTTP Content-Type 标头字段。

extension 参数不区分大小写，可以带或不带前导点指定。

TypesConfig 指令

TypesConfig 指令设置 媒体类型 配置文件的位置。 File-path 相对于 ServerRoot。此文件设置从文件名扩展名到内容类型的默认映射列表。大多数管理员使用其操作系统提供的 mime.types 文件，该文件将常见的文件名扩展名与 IANA 在 http://www.iana.org/assignments/media-types/index.html 上维护的官方媒体类型列表以及大量非官方类型相关联。这通过提供大多数媒体类型定义来简化 httpd.conf 文件，并且可以根据需要被 AddType 指令覆盖。您不应该编辑 mime.types 文件，因为它可能会在您升级服务器时被替换。

该文件包含与 AddType 指令的参数格式相同的行

扩展名的大小写无关紧要。空行和以井号 (#) 开头的行将被忽略。空行是为了完整性（mime.types 文件的完整性）。Apache httpd 仍然可以使用 mod_mime_magic 来确定这些类型。

另请参阅

• mod_mime_magic