Apache模块mod_mime

AddCharset 指令

该AddCharset指令将给定的文件扩展名映射到指定的内容字符集（给定字符编码的Internet注册名称）。charset 是文件类型包含扩展名的资源 的媒体类型的charset参数。该映射将添加到所有已经生效的映射中，从而覆盖同一扩展名已存在的所有映射 。

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指令不仅可以用于通知客户端有关文档的字符编码，以便可以正确地解释和显示文档，还可以用于内容协商（内容协商），其中服务器根据客户端的字符集首选项从多个文档中返回一个文档。

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

也可以看看

• mod_negotiation
• AddDefaultCharset

AddEncoding 指令

该AddEncoding指令将给定的文件扩展名映射到指定的HTTP内容编码。 encoding是HTTP内容编码，用于附加到以扩展名命名的文档的Content-Encoding标头字段的值 。该映射将添加到所有已经生效的映射中，从而覆盖同一扩展名已存在的所有映射 。

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-。

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

AddHandler 指令

具有扩展名的文件将由指定的handler-name服务。该映射将添加到所有已经生效的映射中，从而覆盖同一扩展名已存在的所有映射。例如，要使用文件扩展名激活CGI脚本.cgi，可以使用：

AddHandler cgi-script .cgi

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

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

也可以看看

• SetHandler

AddInputFilter 指令

AddInputFilter将文件扩展名扩展名映射 到过滤器，这些过滤器将在服务器收到客户端请求和POST输入时处理它们。这是在其他地方定义的任何过滤器的补充，包括SetInputFilter 指令。该映射将合并到所有已生效的映射上，从而覆盖同一扩展名已存在的所有映射。

如果指定了多个过滤器，则必须按分号将它们按处理内容的顺序分隔。该过滤器是不区分大小写的。

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

也可以看看

• RemoveInputFilter
• SetInputFilter

AddLanguage 指令

该AddLanguage指令将给定的文件扩展名映射到指定的内容语言。具有文件名扩展名的文件被分配一个HTTP内容语言值language-tag，该值与RFC 3066定义的语言标识符相对应。此伪指令将覆盖该扩展名已经存在的所有映射 。

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。

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

也可以看看

• mod_negotiation

AddOutputFilter 指令

该AddOutputFilter指令将文件名扩展名扩展名映射到过滤器，这些过滤器将在将来自服务器的响应发送给客户端之前对其进行处理。这是在其他地方定义的所有过滤器（包括SetOutputFilter和AddOutputFilterByType指令）的补充。该映射将合并到所有已生效的映射上，从而覆盖同一扩展名已存在的所有映射。

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

AddOutputFilter INCLUDES;DEFLATE shtml

如果指定了多个过滤器，则必须按分号将它们按处理内容的顺序分隔。所述滤波器参数是不区分大小写的。

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

请注意，使用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的文件名 的媒体类型。该映射将添加到所有已经生效的映射中，从而覆盖同一扩展名已存在的所有映射 。

AddType image/gif .gif

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

AddType image/jpeg jpeg jpg jpe

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

到类似的效果mod_negotiation的 LanguagePriority 能够通过限定一个实现媒体类型与 qs：

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

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

该指令主要配置为从文件系统提供的静态文件生成的内容类型。对于静态文件以外的资源（响应的生成器通常指定了Content-Type），该指令无效。

也可以看看

• ForceType
• mod_negotiation

默认语言 指令

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

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

DefaultLanguage en

也可以看看

• mod_negotiation

ModMimeUsePathInfo 指令

该ModMimeUsePathInfo伪指令用于将文件名与path_infoURL组件结合起来，以将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允许mod_negotiation的Multiviews功能具有三种不同的行为。在Multiviews允许文件，请求 例如 index.html，以匹配任何协商扩展以下基本要求，例如 index.html.en，index.html.fr，或 index.html.gz。

该NegotiatedOnly选项提供了基本名称后面的每个扩展名都必须与mod_mime用于内容协商的识别扩展名相关联 ，例如， 字符集，内容类型，语言或编码。这是最严格的实现，具有最少的意外副作用，并且是默认行为。

要包括与处理程序和/或过滤器关联的扩展，设定MultiviewsMatch指令要么 Handlers，Filters或两者选项关键字。如果所有其他因素都相等，则将提供最小的文件， 例如，在index.html.cgi500字节与index.html.pl1000字节之间进行选择时，该.cgi 文件将获胜。.asis如果.asis文件与关联，则文件用户可能更喜欢使用Handler选项asis-handler。

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

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

MultiviewsMatch Handlers Filters

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

也可以看看

• Options
• mod_negotiation

RemoveCharset 指令

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

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

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未编码的纯文本文件。

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

RemoveHandler 指令

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

AddHandler server-parsed .html

RemoveHandler .html

这具有将.html目录中的文件返回/foo/bar为普通文件而不是解析候选文件的效果（请参阅mod_include模块）。

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

RemoveInputFilter 指令

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

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

也可以看看

• AddInputFilter
• SetInputFilter

删除语言 指令

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

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

RemoveOutputFilter 指令

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

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

RemoveOutputFilter shtml

也可以看看

• AddOutputFilter

RemoveType 指令

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

RemoveType .cgi

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

所述扩展参数是不区分大小写的，并且可以带有或不带有前导点来指定。

TypesConfig 指令

该TypesConfig指令设置的位置的媒体类型 的配置文件。文件路径是相对于的 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。

See also

• mod_mime_magic