Apache2.2中文手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
directory search
首页 版本说明 从1.3升级到2.0 编译时配置的改变 运行时配置的改变 杂项变化 第三方模块 从 2.0 升级到 2.2 编译时配置的改变 运行时配置的改变 杂项变化 第三方模块 Apache 2.1/2.2 版本的新特性 核心增强 模块增强 程序增强 针对模块开发者的变化 Apache 2.0 版本的新特性 核心的增强 模块的增强 Apache许可证 参考手册 编译与安装 针对心急者的概述 要求 下载 解压 配置源代码树 编译 安装 配置 测试 升级 启动 Apache是怎样启动的 启动时发生错误 随系统启动时启动 额外信息 停止与重新启动 简介 立即停止 优雅重启 立即重启 优雅停止 附录：信号和竞争条件 运行时配置指令 主配置文件 配置文件的语法 模块 指令的作用域 .htaccess文件 配置段 配置段(容器)的类型 文件系统和网络空间 虚拟主机 代理 允许使用哪些指令？ 配置段的合并 内容缓冲 简介 缓冲概述 安全方面的考虑 文件句柄缓冲 内存缓冲 磁盘缓冲 服务器全局配置 服务器标识 文件定位 限制资源的使用 日志文件 安全警告 错误日志 访问日志 日志滚动 管道日志 虚拟主机 其他日志文件 从URL到文件系统的映射 相关模块和指令 DocumentRoot DocumentRoot以外的文件 用户目录 URL重定向 反向代理 重写引擎 File Not Found 安全方面的提示 保持不断更新和升级 ServerRoot目录的权限 服务器端包含 关于CGI 未指定为脚本的CGI 指定为脚本的CGI 其他动态内容的来源 系统设置的保护 默认配置下服务器文件的保护 观察日志文件 动态共享对象(DSO) 实现 用法概要 背景知识 优点和缺点 内容协商 关于内容协商 Apache中的内容协商 协商的方法 打乱品质值 透明内容协商的扩展 超链和名称转换说明 缓冲说明 更多信息 自定义错误响应 行为 配置 自定义错误响应与重定向 地址和端口绑定 概述 针对IPv6的特殊考虑 怎样与虚拟主机协同工作 多路处理模块(MPM) 简介 选择一个MPM 默认的MPM 环境变量 设置环境变量 使用环境变量 用于特殊目的的环境变量 示例 处理器的使用 什么是处理器？ 例子 程序员注意事项 过滤器 Apache2中的过滤器 智能过虑 使用过滤器 CGI脚本的Suexec执行 开始之前 suEXEC的安全模型 配置和安装suEXEC 启用和禁用suEXEC 使用suEXEC 调试suEXEC 谨防Jabberwock：警告和举例 性能调整 硬件和操作系统 运行时的配置 编译时的配置 附录：踪迹的详细分析 URL重写指南 mod_rewrite简介 实践方案 URL的规划 内容的处理 对访问的限制 其他 虚拟主机文档 总述 虚拟主机支持 配置指令 基于主机名的虚拟主机 基于域名的虚拟主机和基于IP的虚拟主机比较 使用基于域名的虚拟主机 与旧版浏览器的兼容性 基于IP地址的虚拟主机 系统需求 如何配置Apache 设置多个守护进程 配置拥有多个虚拟主机的单一守护进程 动态配置大量虚拟主机 动机 概述 简单的动态虚拟主机 一个实际的个人主页系统 在同一个服务器上架设多个主机的虚拟系统 更为有效的基于IP地址的虚拟主机 使用老版本的Apache 使用mod_rewrite实现简单的动态虚拟主机 使用mod_rewrite的个人主页系统 使用独立的虚拟主机配置文件 虚拟主机的普通配置示例 在一个IP地址上运行多个基于域名的web站点 在多于一个IP的情况下使用基于域名的虚拟主机 在不同的IP的地址(比如一个内部和一个外部地址)上提供相同的内容 在不同的端口上运行不同的站点 建立基于IP的虚拟主机 混用基于端口和基于IP的虚拟主机 混用基于域名和基于IP的虚拟主机 将虚拟主机和代理模块一起使用 使用默认虚拟主机 将一个基于域名的虚拟主机移植为一个基于IP的虚拟主机 使用ServerPath指令 深入讨论虚拟主机的匹配 解析配置文件 虚拟主机匹配 小技巧 文件描述符限制 关于DNS和Apache 一个简单示例 拒绝服务 "主服务器"地址 避免这些问题的小技巧 附录：进一步的提示 常见问题 概述 SSL/TLS 加密 概述 文档 mod_ssl 绪论 密码技术 证书 安全套接字层(SSL) 参考 兼容性 配置指令 环境变量 自定义日志功能 如何... 加密方案和强制性高等级安全 客户认证和访问控制 常见问题解答 About The Module Installation Configuration Certificates The SSL Protocol mod_ssl Support 如何.../指南 概述 认证 相关模块和指令 简介 先决条件 启用认证 允许多人访问 可能存在的问题 其他认证方法 更多信息 CGI动态页面 简介 配置Apache以允许CGI 编写CGI程序 程序还是不能运行！ 幕后是怎样操作的? CGI模块/库 更多信息 服务器端包含 简介 什么是SSI? 配置服务器以允许SSI 基本SSI指令 附加的例子 我还能设置其它什么？ 执行命令 高级SSI技术 总结 .htaccess文件 .htaccess文件 工作原理和使用方法 (不)使用.htaccess文件的场合 指令的生效 认证举例 服务器端包含(SSI)举例 CGI举例 疑难解答 用户网站目录 用户网站目录 用UserDir设置文件路径 限定哪些用户可以使用此功能 启用对每个用户都有效的cgi目录 允许用户改变配置 对特定平台的说明 概述 Microsoft Windows 其他平台 在Microsoft Windows中使用Apache 对操作系统的要求 下载 Apache for Windows 安装 Apache for Windows 配置 Apache for Windows 以服务方式运行 Apache for Windows 作为控制台程序运行Apache 测试安装 编译Windows下的Apache 系统要求 命令行编译 Developer Studio集成开发环境的工作区编译 项目组件 在Novell NetWare平台上使用Apache Requirements Downloading Apache for NetWare Installing Apache for NetWare Running Apache for NetWare Configuring Apache for NetWare Compiling Apache for NetWare 在HP-UX中运行Apache The Apache EBCDIC Port Overview of the Apache EBCDIC Port Design Goals Technical Solution Porting Notes Document Storage Notes Apache Modules' Status Third Party Modules' Status 服务器与支持程序 概述 httpd 语法 选项 ab 语法 选项 Bugs apachectl 语法 选项 apxs 语法 选项 举例 configure 语法 选项 环境变量 dbmmanage 语法 选项 Bugs htcacheclean 语法 选项 返回值 htdbm 语法 选项 Bugs 返回值 举例 安全方面的考虑 限制 htdigest 语法 选项 htpasswd 语法 选项 返回值 举例 安全方面的考虑 限制 logresolve 语法 选项 rotatelogs 语法 选项 Portability suexec 语法 选项 其他程序 log_server_status split-logfile 杂项文档 概述 相关标准 HTTP推荐标准 HTML推荐标准 认证 语言/国家代码 Apache 模块 描述模块的术语 说明 状态 源代码文件 模块标识符 兼容性 描述指令的术语 说明 语法 默认值(Default) 作用域(Context) 覆盖项(Override) 状态 模块(Module) 兼容性(Compatibility) Apache核心(Core)特性 AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AddOutputFilterByType AllowEncodedSlashes AllowOverride AuthName AuthType CGIMapExtension ContentDigest DefaultType <Directory> <DirectoryMatch> DocumentRoot EnableMMAP EnableSendfile ErrorDocument ErrorLog FileETag <Files> <FilesMatch> ForceType HostnameLookups <IfDefine> <IfModule> Include KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests NameVirtualHost Options Require RLimitCPU RLimitMEM RLimitNPROC Satisfy ScriptInterpreterSource ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter TimeOut TraceEnable UseCanonicalName UseCanonicalPhysicalPort <VirtualHost> Apache MPM 公共指令 AcceptMutex CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Group Listen ListenBackLog LockFile MaxClients MaxMemFree MaxRequestsPerChild MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize User Apache MPM beos MaxRequestsPerThread CoreDumpDirectory Group Listen ListenBacklog MaxClients MaxMemFree MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize StartThreads User Apache MPM event AcceptMutex CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog LockFile MaxClients MaxMemFree MaxRequestsPerChild MaxSpareThreads MinSpareThreads PidFile ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize User Apache MPM netware MaxThreads Listen ListenBacklog MaxMemFree MaxRequestsPerChild MaxSpareThreads MinSpareThreads ReceiveBufferSize SendBufferSize StartThreads ThreadStackSize Apache MPM os2 Group Listen ListenBacklog MaxRequestsPerChild MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize SendBufferSize StartServers User Apache MPM prefork 工作方式 MaxSpareServers MinSpareServers AcceptMutex CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog LockFile MaxClients MaxMemFree MaxRequestsPerChild PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers User Apache MPM winnt Win32DisableAcceptEx CoreDumpDirectory Listen ListenBacklog MaxMemFree MaxRequestsPerChild PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ThreadLimit ThreadsPerChild ThreadStackSize Apache MPM worker 工作方式 AcceptMutex CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog LockFile MaxClients MaxMemFree MaxRequestsPerChild MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize User Apache Module mod_actions Action指令 Script指令 Apache Module mod_alias 处理顺序 Alias AliasMatch Redirect RedirectMatch RedirectPermanent RedirectTemp ScriptAlias ScriptAliasMatch Apache Module mod_asis 用法 Apache Module mod_auth_basic AuthBasicAuthoritative AuthBasicProvider Apache Module mod_auth_digest 使用摘要认证 配合 MS Internet Explorer 6 工作 AuthDigestAlgorithm AuthDigestDomain AuthDigestNcCheck AuthDigestNonceFormat AuthDigestNonceLifetime AuthDigestProvider AuthDigestQop AuthDigestShmemSize Apache Module mod_authn_alias 示例 <AuthnProviderAlias> Apache Module mod_authn_anon 示例 Anonymous Anonymous_LogEmail Anonymous_MustGiveEmail Anonymous_NoUserID Anonymous_VerifyEmail Apache Module mod_authn_dbd 配置示例 AuthDBDUserPWQuery AuthDBDUserRealmQuery Apache Module mod_authn_dbm AuthDBMType AuthDBMUserFile Apache Module mod_authn_default AuthDefaultAuthoritative Apache Module mod_authn_file AuthUserFile Apache Module mod_authnz_ldap Contents Operation The require Directives 举例 Using TLS Using SSL Using Microsoft FrontPage with mod_authnz_ldap AuthLDAPBindDN AuthLDAPBindPassword AuthLDAPCharsetConfig AuthLDAPCompareDNOnServer AuthLDAPDereferenceAliases AuthLDAPGroupAttribute AuthLDAPGroupAttributeIsDN AuthLDAPRemoteUserIsDN AuthLDAPUrl AuthzLDAPAuthoritative Apache Module mod_authz_dbm AuthDBMGroupFile AuthzDBMAuthoritative AuthzDBMType Apache Module mod_authz_default AuthzDefaultAuthoritative Apache Module mod_authz_groupfile AuthGroupFile AuthzGroupFileAuthoritative Apache Module mod_authz_host Allow Deny Order Apache Module mod_authz_owner 配置示例 AuthzOwnerAuthoritative Apache Module mod_authz_user AuthzUserAuthoritative Apache Module mod_autoindex Autoindex Request Query Arguments AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexIgnore IndexOptions IndexOrderDefault IndexStyleSheet ReadmeName Apache Module mod_cache Related Modules and Directives 配置示例 CacheDefaultExpire CacheDisable CacheEnable CacheIgnoreCacheControl CacheIgnoreHeaders CacheIgnoreNoLastMod CacheLastModifiedFactor CacheMaxExpire CacheStoreNoStore CacheStorePrivate Apache Module mod_cern_meta MetaDir MetaFiles MetaSuffix Apache Module mod_cgi CGI 环境变量 CGI 脚本的调试 ScriptLog ScriptLogBuffer ScriptLogLength Apache Module mod_cgid ScriptSock ScriptLog ScriptLogBuffer ScriptLogLength Apache Module mod_charset_lite Common Problems CharsetDefault CharsetOptions CharsetSourceEnc Apache Module mod_dav Enabling WebDAV Security Issues Complex Configurations Dav DavDepthInfinity DavMinTimeout Apache Module mod_dav_fs DavLockDB Apache Module mod_dav_lock DavGenericLockDB Apache Module mod_dbd Connection Pooling Apache DBD API SQL Prepared Statements DBDExptime DBDKeep DBDMax DBDMin DBDParams DBDPersist DBDPrepareSQL DBDriver Apache Module mod_deflate 配置举例 启用压缩 代理服务器 DeflateBufferSize DeflateCompressionLevel DeflateFilterNote DeflateMemLevel DeflateWindowSize Apache Module mod_dir DirectoryIndex DirectorySlash Apache Module mod_disk_cache CacheDirLength CacheDirLevels CacheMaxFileSize CacheMinFileSize CacheRoot Apache Module mod_dumpio 启用dumpio支持 DumpIOInput DumpIOOutput Apache Module mod_echo ProtocolEcho Apache Module mod_env PassEnv SetEnv UnsetEnv Apache Module mod_example Compiling the example module Using the mod_example Module Example Apache Module mod_expires 交替间隔语法 ExpiresActive ExpiresByType ExpiresDefault Apache Module mod_ext_filter 举例 ExtFilterDefine ExtFilterOptions Apache Module mod_file_cache Using mod_file_cache CacheFile MMapFile Apache Module mod_filter Smart Filtering Filter Declarations Configuring the Chain Examples Protocol Handling FilterChain FilterDeclare FilterProtocol FilterProvider FilterTrace Apache Module mod_headers 处理顺序 前处理和后处理 举例 Header RequestHeader Apache Module mod_ident IdentityCheck IdentityCheckTimeout Apache Module mod_imagemap New Features Imagemap File Example Mapfile Referencing your mapfile ImapBase ImapDefault ImapMenu Apache Module mod_include Enabling Server-Side Includes PATH_INFO with Server Side Includes Basic Elements Include Variables Variable Substitution Flow Control Elements SSIEndTag SSIErrorMsg SSIStartTag SSITimeFormat SSIUndefinedEcho XBitHack Apache Module mod_info 安全问题 选择哪些信息可以被显示 已知的局限 AddModuleInfo Apache Module mod_isapi 用法 附加注释 程序员注记 ISAPIAppendLogToErrors ISAPIAppendLogToQuery ISAPICacheFile ISAPIFakeAsync ISAPILogNotSupported ISAPIReadAheadBuffer Apache Module mod_ldap 示例配置 LDAP 连接池 LDAP 缓冲 使用SSL/TLS SSL/TLS 证书 LDAPCacheEntries LDAPCacheTTL LDAPConnectionTimeout LDAPOpCacheEntries LDAPOpCacheTTL LDAPSharedCacheFile LDAPSharedCacheSize LDAPTrustedClientCert LDAPTrustedGlobalCert LDAPTrustedMode LDAPVerifyServerCert Apache Module mod_log_config 定制日志文件格式 安全考虑 BufferedLogs CookieLog CustomLog LogFormat TransferLog Apache Module mod_log_forensic 定制日志文件格式 安全考虑 ForensicLog Apache Module mod_logio 定制日志文件格式 Apache Module mod_mem_cache MCacheMaxObjectCount MCacheMaxObjectSize MCacheMaxStreamingBuffer MCacheMinObjectSize MCacheRemovalAlgorithm MCacheSize Apache Module mod_mime 带多扩展名的文件 内容编码 字符集和语言 AddCharset AddEncoding AddHandler AddInputFilter AddLanguage AddOutputFilter AddType DefaultLanguage ModMimeUsePathInfo MultiviewsMatch RemoveCharset RemoveEncoding RemoveHandler RemoveInputFilter RemoveLanguage RemoveOutputFilter RemoveType TypesConfig Apache Module mod_mime_magic "Magic文件"的格式 性能问题 注意 MimeMagicFile Apache Module mod_negotiation 类型表 MultiViews CacheNegotiatedDocs ForceLanguagePriority LanguagePriority Apache Module mod_nw_ssl NWSSLTrustedCerts NWSSLUpgradeable SecureListen Apache Module mod_proxy 正向和反向代理 简单示例 控制对代理服务器的访问 缓慢启动 局域网代理 协议调整 请求体 AllowCONNECT NoProxy <Proxy> ProxyBadHeader ProxyBlock ProxyDomain ProxyErrorOverride ProxyIOBufferSize <ProxyMatch> ProxyMaxForwards ProxyPass ProxyPassReverse ProxyPassReverseCookieDomain ProxyPassReverseCookiePath ProxyPreserveHost ProxyReceiveBufferSize ProxyRemote ProxyRemoteMatch ProxyRequests ProxyTimeout ProxyVia Apache Module mod_proxy_ajp Overview of the protocol Basic Packet Structure Request Packet Structure Response Packet Structure Apache Module mod_proxy_balancer Load balancer scheduler algorithm Request Counting Algorithm Weighted Traffic Counting Algorithm Enabling Balancer Manager Support Apache Module mod_proxy_connect Apache Module mod_proxy_ftp 为什么xxx类型的文件不能从FTP下载？ 如何强制文件xxx使用FTP的ASCII形式下载？ 我如何使用FTP上传？ 我如何能访问我自己home目录以外的FTP文件？ 我如何才能在浏览器的URL框中隐藏FTP的明文密码？ Apache Module mod_proxy_http Apache Module mod_rewrite 特殊字符的引用 环境变量 实用方案 RewriteBase RewriteCond RewriteEngine RewriteLock RewriteLog RewriteLogLevel RewriteMap RewriteOptions RewriteRule Apache Module mod_setenvif BrowserMatch BrowserMatchNoCase SetEnvIf SetEnvIfNoCase Apache Module mod_so 为Windows创建可加载模块 LoadFile LoadModule Apache Module mod_speling CheckSpelling Apache Module mod_ssl 环境变量 Custom Log Formats SSLCACertificateFile SSLCACertificatePath SSLCADNRequestFile SSLCADNRequestPath SSLCARevocationFile SSLCARevocationPath SSLCertificateChainFile SSLCertificateFile SSLCertificateKeyFile SSLCipherSuite SSLCryptoDevice SSLEngine SSLHonorCipherOrder SSLMutex SSLOptions SSLPassPhraseDialog SSLProtocol SSLProxyCACertificateFile SSLProxyCACertificatePath SSLProxyCARevocationFile SSLProxyCARevocationPath SSLProxyCipherSuite SSLProxyEngine SSLProxyMachineCertificateFile SSLProxyMachineCertificatePath SSLProxyProtocol SSLProxyVerify SSLProxyVerifyDepth SSLRandomSeed SSLRequire SSLRequireSSL SSLSessionCache SSLSessionCacheTimeout SSLUserName SSLVerifyClient SSLVerifyDepth Apache Module mod_status Enabling Status Support 自动更新 Machine Readable Status File ExtendedStatus Apache Module mod_suexec SuexecUserGroup Apache Module mod_unique_id Theory Apache Module mod_userdir UserDir Apache Module mod_usertrack Logging 2-digit or 4-digit dates for cookies? CookieDomain CookieExpires CookieName CookieStyle CookieTracking Apache Module mod_version <IfVersion> Apache Module mod_vhost_alias 目录名称的转换 示例 VirtualDocumentRoot VirtualDocumentRootIP VirtualScriptAlias VirtualScriptAliasIP 开发者文档 Overview Topics External Resources Apache API notes Basic concepts How handlers work Resource allocation and resource pools Configuration Debugging Memory Allocation in APR Available debugging options Allowable Combinations Activating Debugging Options Documenting Apache 2.0 Apache 2.0 Hook Functions Creating a hook function Hooking the hook Converting Modules from Apache 1.3 to Apache 2.0 The easier changes ... The messier changes... Request Processing in Apache 2.0 The Request Processing Cycle The Request Parsing Phase The Security Phase The Preparation Phase The Handler Phase How Filters Work in Apache 2.0 Filter Types How are filters inserted? Asis Explanations 词汇和索引 词汇表 模块索引 指令索引 指令速查 译者声明

©
This document usesPHP Chinese website manualRelease

characters

Apache模块 mod_mime

说明 根据文件扩展名决定应答的行为(处理器/过滤器)和内容(MIME类型/语言/字符集/编码)
状态 基本(B)
模块名 mime_module
源文件 mod_mime.c

概述

本模块通过文件的扩展名将不同的"元信息"与文件关联起来。元信息在文档的文件名与文档的MIME类型、语言、字符集、编码方式之间建立关联。最终元信息会传送到服务器并参与内容协商，这样最终在考虑用户指定参数的基础上，在几个可能的文件里选择一个提供服务。关于内容协商的更多信息，请参阅mod_negotiation模块。

AddCharset,AddEncoding,AddLanguage,AddType指令都可以用于在文件的扩展名与文件的元信息之间建立映射关系。它们分别指明了文档的字符集、编码方式、语言、MIME类型(内容类型)。指令TypesConfig用来指定一个文件，它也包含了扩展名到MIME类型的映射关系。

另外，mod_mime还可以定义处理器和过滤器来生成或处理信息。指令AddHandler,AddOutputFilter,AddInputFilter控制了提供文档的模块或脚本的运作方式。MultiviewsMatch指令设定mod_negotiation模块在尝试Multiview匹配时，如何处理文件扩展名。

当mod_mime模块在元信息与文件的扩展名之间建立映射以后，core提供了一组指令用来建立某个给定范围内(也就是,,)所有相关文件与特定的元信息之间的关联。这些指令包括ForceType,SetHandler,SetInputFilter,SetOutputFilter。core的指令会覆盖任何在mod_mime模块中定义的文件扩展名映射。

注意，改变一个文件的元信息，不会改变Last-Modified头的值。因此，以前被缓存的副本可能还会被用户或代理服务器使用。如果你改变了元信息(语言、内容类型、字符集、编码方式)，你需要"触及"所有相关文件(更新他们的最后修改时间)，以保证所有的访问者都收到正确的内容标题。

带多扩展名的文件

文件可以有多个扩展名，这些扩展名的顺序一般情况下是无关紧要的。例如：如果文件welcome.html.fr被映射为内容类型是text/html、语言是法语的话，文件welcome.fr.html将被映射为完全相同的内容。如果一个以上的扩展名映射到同种类型的元信息上，那么将使用最右边的那个。比如：.gif的MIME类型是image/gif、.html的MIME类型是text/html，那么welcome.gif.html的MIME类型将是text/html。

语言和内容编码会按照积累的方式处理，因为一个文件可以被指定为多种语言或编码。因此，welcome.html.en.de文件将会按照Content-Language: en, de和Content-Type: text/html发送。

在处理带多个扩展名的文件并且这些扩展名同时关联MIME类型和处理器时，要特别小心。这种情况下通常是由与处理器相关的模块来处理得到结果。比如，文件扩展名.imap(通过mod_imagemap模块)与imap-file处理器相关联，同时，.html文件扩展名的MIME类型是text/html，那么文件world.imap.html将同时与imap-file处理器和text/htmlMIME类型相关联。在处理这种情况的时候，imap-file处理器会被选用，因此，这个文件会被当作由mod_imagemap模块处理的图像映射文件。

内容编码

一个具有特定MIME类型的文件能够用一种特定的方法进行额外的编码，以简化它在互联网上的传输。这通常指的是压缩，比如gzip；也可以是加密，例如pgp；还可以是像UUencoding那样的编码，UUencoding是用来在ASCII(文本)格式的文件里，传输二进制文件的编码方式。

HTTP/1.1 RFC第14.11节是这样解释的：

实体头的"Content-Encoding"域是媒体类型的修饰符。如果存在，它的值指明了对实体本身进行额外编码的方式，以及为了得到"Content-Type"头所参照的媒体类型而必须采用的解码机制。"Content-Encoding"主要用来允许一个文件在不破坏它底层媒体类型的基础上，进行压缩。

通过使用一种以上的文件扩展名(参见上面关于带多扩展名的文件一节)，你可以指定文件是一种特定的类型，还可以同时指定它特定的编码方式。

例如，你有一个文件，它是Microsoft Word文档，同时为了减小它的大小，它还被压缩了。如果.doc扩展名表示Microsoft Word文件类型，而.zip扩展名表示pkzip文件编码方式，那么文件Resume.doc.zip就会被认出是一个用pkzip压缩过的Word文档。

Apache把一个Content-encoding头和请求的资源一起发送，以便告诉浏览器资源编码的方式。

Content-encoding: pkzip

字符集和语言

除了文件类型和文件编码方式外，还有一个重要的信息是文件的语言以及文件显示时的字符集。例如一个文档可能是用越南语或古斯拉夫语写的，并且也应该显示成这种语言。这样的信息也要在HTTP头里进行传输。

字符集、语言、编码方式、内容类型等信息都是用在内容协商(参阅mod_negotiation模块)处理过程中的。它们决定了当许多包含了不同的字符集、语言、编码方式、内容类型的文档都存在时，具体将哪个文档返回给客户端。所有由AddCharset,AddEncoding,AddLanguage,AddType指令定义的文件扩展名关联(还有在MimeMagicFile指令中列出的文件扩展名)都参与了这个选择过程。使用AddHandler,AddInputFilter,AddOutputFilter指令建立的关联，可以用MultiviewsMatch指令来决定参与或不参与匹配。

字符集

为了传递更深层次的信息，Apache在传送一个Content-Language头以指定文档语言的基础上，还在随后的Content-Type头中指明了具体的字符集，以便更精确地描述这一信息。

Content-Language: en, fr
Content-Type: text/plain; charset=ISO-8859-1

语言的标识是这个语言名字的二字母缩写。charset是使用的字符集的精确名字。

AddCharset指令

说明 在给定的文件扩展名与特定的字符集之间建立映射
语法 AddCharsetcharsetextension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

AddCharset指令在特定的文件扩展名与特定的字符集之间建立映射。charset是以extension为扩展名的文件的MIME字符集参数。这个映射关系会强制添加在所有现存的映射关系上，并覆盖所有现存的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参数是大小写无关的，并且可以带或不带前导点。

参见

  • mod_negotiation
  • AddDefaultCharset

AddEncoding指令

说明 在文件扩展名与特定的编码方式之间建立映射关系
语法 AddEncodingMIME-encextension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

AddEncoding指令在文件扩展名与特定的编码方式之间建立映射关系。指令定义以extension为扩展名的文件是由MIME-enc方式编码的。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的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参数是大小无关的，并且可以带或不带前导点。

AddHandler指令

说明 在文件扩展名与特定的处理器之间建立映射
语法 AddHandlerhandler-nameextension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

AddHandler cgi-script .cgi

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

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

参见

  • SetHandler

AddInputFilter指令

说明 在文件扩展名与特定的输入过滤器之间建立映射
语法 AddInputFilterfilter[;filter...]extension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.26 及以后的版本中可用

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

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

参见

  • RemoveInputFilter
  • SetInputFilter

AddLanguage指令

说明 在文件扩展名与特定的语言之间建立映射
语法 AddLanguageMIME-langextension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

AddLanguage指令在文件扩展名与特定的语言之间建立映射。指令定义以extension为扩展名的文件是以MIME-lang语言写成的。这个映射关系会添加在所有有效的映射关系上，并覆盖所有相同的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参数是大小无关的，并且可以带或不带前导点。

参见

  • mod_negotiation

AddOutputFilter指令

说明 在文件扩展名与特定的输出过滤器之间建立映射关系
语法 AddOutputFilterfilter[;filter...]extension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.26 及以后的版本中可用

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

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

AddOutputFilter INCLUDES;DEFLATE shtml

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

参见

  • RemoveOutputFilter
  • SetOutputFilter

AddType指令

说明 在给定的文件扩展名与特定的内容类型之间建立映射
语法 AddTypeMIME-typeextension[extension] ...
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

示例

AddType image/gif .gif

推荐使用 AddType指令增加新的媒体类型映射关系，而不是改变 TypesConfig文件。

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

参见

  • DefaultType
  • ForceType

DefaultLanguage指令

说明 为所有文件设定特定的默认语言
语法 DefaultLanguageMIME-lang
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

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

示例

DefaultLanguage en

参见

  • mod_negotiation

ModMimeUsePathInfo指令

说明 将path_info当成是文件名的一个组成部分
语法 ModMimeUsePathInfo On|Off
默认值 ModMimeUsePathInfo Off
作用域 directory
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.41 及以后的版本中可用

ModMimeUsePathInfo指令用来设定在使用由mod_mime提供的指令时，是否将URL的path_info与文件名结合起来进行处理。默认值为Off，也就是说URL的path_info部分被忽略。

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

示例

ModMimeUsePathInfo On

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

参见

  • AcceptPathInfo

MultiviewsMatch指令

说明 在使用MultiViews查询所匹配的文件时要包含的文件类型
语法 MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters]
默认值 MultiviewsMatch NegotiatedOnly
作用域 server config, virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.26 及以后的版本中可用

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选项来使它匹配用户的请求。Apaceh1.3就是按这个方式处理的，这会导致无法预测的结果，比如匹配了网站管理员从来不希望使用的.old或.bak文件。

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

MultiviewsMatch Handlers Filters

参见

  • Options
  • mod_negotiation

RemoveCharset指令

说明 删除任何给定的扩展名与内容字符集之间的关联
语法 RemoveCharsetextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.24 及以后的版本中可用

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

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

示例

RemoveCharset .html .shtml

RemoveEncoding指令

说明 删除任何给定的扩展名与内容编码方式之间的关联
语法 RemoveEncodingextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

/foo/.htaccess:

AddEncoding x-gzip .gz
AddType text/plain .asc

RemoveEncoding .gz

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

注意

RemoveEncoding指令在所有AddEncoding指令之后处理，因此如果在同一个目录配置里两者都出现的话，RemoveEncoding指令将会取消后面的AddEncoding指令的作用。

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

RemoveHandler指令

说明 删除任何指定扩展名与处理器之间的关联
语法 RemoveHandlerextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

/foo/.htaccess

AddHandler server-parsed .html

/foo/bar/.htaccess

RemoveHandler .html

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

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

RemoveInputFilter指令

说明 删除指定扩展名与输入过滤器之间的关联
语法 RemoveInputFilterextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.26 及以后的版本中可用

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

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

参见

  • AddInputFilter
  • SetInputFilter

RemoveLanguage指令

说明 删除指定的扩展名与内容语言之间的关联
语法 RemoveLanguageextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 Apache 2.0.24 及以后的版本中可用

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

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

RemoveOutputFilter指令

说明 删除指定扩展名与输出过滤器之间的关联
语法 RemoveOutputFilterextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime
兼容性 仅在 2.0.26 及以后的版本中可用

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

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

示例

RemoveOutputFilter shtml

参见

  • AddOutputFilter

RemoveType指令

说明 删除指定扩展名与内容类型之间的关联
语法 RemoveTypeextension[extension] ...
作用域 virtual host, directory, .htaccess
覆盖项 FileInfo
状态 基本(B)
模块 mod_mime

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

/foo/.htaccess

RemoveType .cgi

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

注意

RemoveType指令会在所有的AddType指令之后处理，因此，当同一个目录配置中，同时存在这两种指令的时候，前面的RemoveType指令将会取消后面的AddType指令的作用。

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

TypesConfig指令

说明 指定mime.types文件的位置
语法 TypesConfigfile-path
默认值 TypesConfig conf/mime.types
作用域 server config
状态 基本(B)
模块 mod_mime

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

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

MIME-type[extension] ...

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

请 不要要求Apache HTTP服务器项目组在已发布的 mime.types文件中增加新的项，除非(1)它们已经在IANS注册过了，或者(2)它们被广泛地使用，并且在多平台上没有文件扩展名冲突发生。 category/x-subtype请求会被自动拒绝，因为任何新的二字母的扩展名很可能会与已经非常拥挤的语言及字符集名字空间冲突。

参见

  • mod_mime_magic
Previous article： Next article：