Apache模块 mod_mime

AddCharset 指令

AddCharset 指令为给定的文件扩展名与特定的内容字符集建立映射。指令定义包含extension扩展名的文件是采用charset字符集的。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的extension扩展名映射。

有了以上定义以后，文档xxxx.ja.jis 会被当成是使用字符集ISO-2022-JP 的日文文档(文档xxxx.jis.ja也一样)。AddCharset 指令在通知客户端文档的字符集编码方式，以便正确地翻译和显示，以及服务器根据用户的优先选择信息，从几个文档中进行内容协商，以决定最后哪个文档被返回时非常有用。

extension 参数是大小无关的，并且可以带也可以不带先导的点。

参见

• mod_negotiation
• AddDefaultCharset

AddEncoding 指令

AddEncoding 指令在文件扩展名与特定的编码方式间建立映射关系。指令定义以extension为扩展名的文件是由MIME-enc方式编码的。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的extension扩展名映射。

有了以上定义以后，包含.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 参数是大小无关的，并且可以带也可以不带先导的点。

AddHandler 指令

指定带extension扩展名的文件应被handler-name处理器 来处理。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的extension扩展名映射。例如：为了把扩展名为.cgi的文件作为CGI脚本来处理，你应该定义：

一旦以上的定义放在你的http.conf文件中，所有包含.cgi扩展名的文件，都会被当成是CGI程序。

extension 参数是大小无关的，并且可以带也可以不带先导的点。

参见

• SetHandler

AddInputFilter 指令

AddInputFilter 指令在文件扩展名extension与对服务器收到的客户请求进行处理与转发的输入过滤器间建立映射。这是除包括SetInputFilter 指令在内，所有过滤器定义指令之外定义。这个映射会与所有有效的定义合并，并覆盖所有相同的extension扩展名映射。

如果要指定一个以上的过滤器，它们必须用分号来分隔，并按它们处理文档的顺序来排列。filter与extension参数都是大小无关的，extension可以带也可以不带先导的点。

AddLanguage 指令

AddLanguage 指令在文件扩展名与特定的内容语言间建立映射。指令定义以extension为扩展名的文件是以MIME-lang语言写成的。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的extension扩展名映射。

文档xxxx.en.Z会被当成是一个压缩的英文文档(xxxx.Z.en也一样）。虽然内容语言会返回给客户端，但浏览器未必会使用这一信息。AddLanguage 指令在服务器根据用户的优先选择信息，从几个文档中进行内容协商，以决定最后哪个文档被返回时非常有用。

如果同一个扩展名被赋予多个语言，那么使用最后出现的那个。因此在下列情况中：

带.en扩展名的文档会被当成是en-us。

extension 参数是大小无关的，并且可以带也可以不带先导的点。

参见

• mod_negotiation

AddOutputFilter 指令

AddOutputFilter 指令在文件扩展名extension与对服务将返回给客户的信息进行处理的输出过滤器间建立映射。这是除包括SetOutputFilter 和 AddOutputFilterByType指令在内，所有过滤器定义指令之外定义。这个映射会与所有有效的定义合并，并覆盖所有相同的extension扩展名映射。

例如，下列的配置会在处理所有的.shtml文件时，进行服务器端包含，并同时使用mod_deflate模块压缩后输出。

如果要指定一个以上的过滤器，它们必须用分号来分隔，并按它们处理文档的顺序来排列。filter与extension参数都是大小写无关的，extension可以带也可以不带先导的点。

参见

• RemoveOutputFilter

AddType 指令

AddType 指令在给定的文件扩展名与特定的内容类型间建立映射关系。MIME-type指明了包含extension扩展名的文件的媒体类型。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的extension扩展名映射。本指令可用来增加没有在媒体类型文件(参阅TypesConfig 指令)中定义的映射关系。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

参见

• DefaultType
• ForceType

DefaultLanguage 指令

DefaultLanguage 指令告诉Apache，当指令作用域范围(例如，所有当前<Directory> 指令封装范围内的所有文件)的文件没有明确的语言扩展名(例如由AddLanguage 指令定义的.fr 或.de)时，文件应该被认为是由MIME-lang语言构成的。举例来说，这就允许在不必对每个文件进行重命名的情况下，把整个目录中的文件标记为包含荷兰语内容。注意不同于用扩展名来指定语言，DefaultLanguage 指令只能指定一种语言。

如果没有提供有效的DefaultLanguage 指令，同时文件也不包含由AddLanguage 指令定义的语言扩展名，那么这个文件被认为是没有语言属性的。

参见

• mod_negotiation

ModMimeUsePathInfo 指令

ModMimeUsePathInfo 指令用来设定调用mod_mime的指令时，是否将URL的路径信息与文件名结合起来进行处理。缺省值为Off，也就是说URL的path_info部分被忽略。

当你使用虚拟文件系统的时候，推荐使用本指令。

对/bar/foo.shtml这样的请求来说，/bar是一个位置信息，如果ModMimeUsePathInfo 指令为On，mod_mime会将请求解析成/bar/foo.shtml，那么象AddOuptputFilter INCLUDES .shtml 这样的指令会使用INCLUDES过滤器来对这个请求进行处理。如果ModMimeUsePathInfo 指令没有设定，那么就不会使用INCLUDES过滤器。

参见

• AcceptPathInfo

MultiviewsMatch 指令

MultiviewsMatch 指令在实现mod_negotiation 模块的Multiviews功能时，提供三种不同的处理方法。Multiviews允许对一个文件的请求，可以用任何在基础请求后面跟上协商扩展名的情况来匹配，例如：index.html，可以用index.html.en，index.html.fr或index.html.gz来匹配。

NegotiatedOnly 选项规定每个跟在基础名字后面的扩展名必须关联到一个在内容协商时已知的mod_mime扩展名，例如：字符集，内容类型，语言或编码方式。这是一种最严格也是副作用最少的实现方法，它是缺省的处理方式。

为了包含与处理器和/或过滤器关联的扩展名，可以设定MultiviewsMatch 指令为Handlers或Filters，也可以两个都选。如果其它所有的因素都相等，会选中最小的那个文件来提供服务。例如：在一个500字节的index.html.cgi文件和一个1000字节的index.html.pl文件中做选择时，.cgi文件会胜出。如果.asis文件与asis-handler处理器关联，对.asis文件的请求就会使用到处理器选项指明的处理器。

即使mod_mime不认识的扩展名，你最终也可以通过使用Any选项来使它匹配用户的请求。Apaceh 1.3就是按这个方式处理的，这会导致无法预测的结果，比如匹配了网站管理员从来不希望使用的.old或.bak文件。

例如，下面的配置允许在Multviews查询中使用处理器和过滤器，但会拒绝未知的文件：

参见

• Options
• mod_negotiation

RemoveCharset 指令

RemoveCharset 指令删除任何给定的扩展名与内容字符集之间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与内容字符集之间的关联关系。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

RemoveEncoding 指令

RemoveEncoding 指令删除任何给定的扩展名与内容编码方式间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与内容编码方式之间的关联关系。举例来说，它可以这样来使用：

这样，foo.gz被认为是用gzip方式编码的，但foo.gz.asc被认为是一个未编码的纯文本文件。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

RemoveHandler 指令

RemoveHandler 指令删除任何指定的扩展名与处理器间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与处理器之间的关联关系。举例来说，它可以这样来使用：

这样/foo/bar目录中的.html文件将被当成普通文件来处理，而不是由parsing处理器(参阅mod_include模块)来处理。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

RemoveInputFilter 指令

RemoveInputFilter 指令删除指定的扩展名与输入过滤器之间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与输入过滤器之间的关联关系。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

RemoveLanguage 指令

RemoveLanguage 指令删除指定的扩展名与内容语言之间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与内容语言之间的关联关系。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

RemoveOutputFilter 指令

RemoveOutputFilter 指令删除指定的扩展名与输出过滤器之间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与输出过滤器之间的关联关系。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

参见

• AddOutputFilter

RemoveType 指令

RemoveType 指令删除指定的扩展名与内容类型之间的关联。子目录中的.htaccess文件可以通过这条指令取消从父目录或服务器配置文件中继承过来的扩展名与内容类型之间的关联关系。举例来说，它可以这样来使用：

这将删除/foo目录及其所有子目录下.cgi文件的特定处理方式，从而使这些文件按DefaultType 指令设定的缺省类型来处理。

extension 参数是大小写无关的，并且可以带也可以不带先导的点。

TypesConfig 指令

TypesConfig 指令设定媒体类型配置文件的位置。File-path路径是相对于ServerRoot目录的。媒体类型配置文件列出了文件扩展名与内容类型的缺省映射关系。大多数管理员使用既定的mime.types列表文件，它关联了文件扩展名和由IANA注册的内容类型。最新的列表可以在http://www.isi.edu/in-notes/iana/assignments/media-types/media-types得到。这样做可以大大简化httpd.conf文件里的媒体类型定义，在需要时，也可以用AddType 指令来更改这些定义。你不应该编辑mime.types文件，因为在服务器升级的时候，它会被覆盖。

文件包含类似于AddType 指令参数格式的行：

扩展名的大小写是无关紧要的。空行以前以井号(#)打头的行会被忽略。

参见

• mod_mime_magic