# Apache模块 mod_headers
| [说明](#calibre_link-11) | 允许通过配置文件控制任意的HTTP请求和应答头信息 |
| --- | --- |
| [状态](#calibre_link-12) | 扩展(E) |
| [模块名](#calibre_link-13) | headers_module |
| [源文件](#calibre_link-14) | mod_headers.c |
| [兼容性](#calibre_link-58) | `RequestHeader`仅在 Apache 2.0 中有效 |
### 概述
这个模块提供了一些指令用于控制和修改HTTP请求头和应答头。这些头可以被合并、替换、删除。
## 处理顺序
由`mod_headers`提供的指令几乎可以出现在配置文件的任何部分。并可以封装在[配置段](#calibre_link-256)中以限制其作用范围。
指令的处理顺序很重要，它取决于指令本身在配置文件中的位置和所属[配置段](#calibre_link-452)在配置文件中的位置。下面的指令如果颠倒一下顺序将会导致完全不同的结果：
```
RequestHeader append MirrorID "mirror 12"
RequestHeader unset MirrorID
```
当前顺序下，`MirrorID`头不会被设置。若颠倒一下顺序，`MirrorID`头将被设为"mirror 12"。
## 前处理和后处理
`mod_headers`可以应用在请求被处理之前或之后。通常的模式是"后处理"，也就是在请求处理完毕之后、发送应答之前设置应答头。[原文：when Request Headers are set immediately before running the content generator and Response Headers just as the response is sent down the wire.]在实际工作的服务器上应当始终使用"后处理"模式。
"前处理"模式应当仅仅作为开发者使用的一种测试/调试辅助工具。可以在指令中使用`early`关键字启用"前处理"模式，此时将在处理请求之前设置请求头。这样就可以模拟各种不同的请求以协助调试。
由于"前处理"模式的指令在将URL映射到文件系统之前就生效了，不能依赖于所请求的路径。所以"前处理"模式的指令只能用在主服务器和虚拟主机部分的配置中，而不能用于`<Directory>`或`<Location>`配置段中。
## 示例
1. 将所有以"TS"开头的请求头复制到应答头中：
```
Header echo ^TS
```
2. 在应答中添加一个`MyHeader`头来包含服务端接受到请求的时间戳和经过多少时间以后才完成对该请求的处理并作出应答。这个头可以让客户端知道瓶颈位于服务端还是位于服务端和客户端之间的线路。
```
Header add MyHeader "%D %t"
```
上面的设置将会添加如下应答头内容：
```
MyHeader: D=3775428 t=991424704447256
```
3. 向Joe问好(Hello)：
```
Header add MyHeader "Hello Joe. It took %D microseconds \
for Apache to serve this request."
```
上面的设置将会添加如下应答头内容：
```
MyHeader: Hello Joe. It took D=3775428 microseconds for Apache to serve this request.
```
4. 当且仅当"MyRequestHeader"出现在请求头中的时候才在应答中发送"`MyHeader`"头。这个对根据特定的客户端构造特定的应答头很有用。注意，下面的例子需要`mod_setenvif`模块的支持。
```
SetEnvIf MyRequestHeader value HAVE_MyRequestHeader
Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
```
如果请求中出现"`MyRequestHeader: value`"头，应答中将会包含下面的头：
```
MyHeader: D=3775428 t=991424704447256 mytext
```
## Header 指令
| [说明](#calibre_link-18) | 配置HTTP应答头 |
| --- | --- |
| [语法](#calibre_link-19) | `Header [condition] set|append|add|unset|echo header [value] [early|env=[!]variable]` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_headers |
这个指令可以替换、合并、删除HTTP应答头。应答头紧跟在内容处理器和输出过滤器完工之后生成，这时候才能对头进行修改。
condition选项可以是`onsuccess`或`always` 。它决定了将对哪个内部头(internal header)表进行操作。`onsuccess`表示"`2xx`"状态码，`always`表示所有状态码(包含"`2xx`")。特别地，如果你想撤销由某个模块设置的头，你应当做做试验，以找到是那个表产生的影响。
该指令执行的动作是由第二个参数决定的。这个参数取值范围如下：
`set`
设置新的或修改已经存在的同名应答头。value可以是一个格式字符串。
`append`
向同名应答头添加新内容而不修改原来已经存在的旧内容。当向一个已经存在的头添加新值时，将用逗号与原来已经存在的旧值分开。这是向HTTP头赋以多个值的标准方法。
`add`
向应答中添加新的头而不修改原来已经存在的头(即使同名)。这将可能导致有两个或更多的应答头具有相同的名字，从而导致意想不到的后果，所以通常不使用这种方法而用`append`来代替它。
`unset`
去除应答中同名的头(若存在的话)。如果有多个头同名，则会被全部去除。value必须被省略。
`echo`
将请求中同名的头复制到应答中。header可以是一个[正则表达式](#calibre_link-67 "see glossary")。value必须被省略。
这个参数后面必须要跟一个header名字(结尾的冒号可要可不要)。`set`, `append`, `add`, `unset`是大小写无关的。用于`echo`的header是大小写敏感的，并且可以是一个[正则表达式](#calibre_link-67 "see glossary")。
对于`add`, `append`, `set`来说，value是第三个参数。如果value包含空格则必须用双引号(")括起来。value可以是一个普通字符串或包含格式说明符的字符串，value支持下列格式字符串：
| 格式 | 描述 |
| --- | --- |
| `%%` | 百分号(%) |
| `%t` | 接收到请求的微秒时间戳(相对于1970-1-1 00:00:00 UCT)，外加一个"`t=`"前缀。 |
| `%D` | 从接收到请求到完成对该请求的处理并作出应答共花费了多少微秒，外加一个"`D=`"前缀。 |
| `%{FOOBAR}e` | [环境变量](#calibre_link-232)`FOOBAR`的内容 |
| `%{FOOBAR}s` | [SSL环境变量](#calibre_link-486)`FOOBAR`的内容(如果启用了`mod_ssl`) |
### 注意
"`%s`"格式符仅在Apache 2.1及以后的版本中可用。它可以代替"`%e`"以避免"`SSLOptions +StdEnvVars`"带来的额外开销。如果因为别的原因必须开启"`SSLOptions +StdEnvVars`"，那么"`%e`"将比"`%s`"更加合适。
`Header`后面可以跟一个用于指定生效条件的额外参数(或者用`early`表示"[前处理](#calibre_link-956)")。如果在"`env=...`"参数中指定的[环境变量](#calibre_link-232)存在(或用"`env=!...`"表示不存在)，那么`Header`指令指定的动作将会生效，否则将不会生效。
除非使用[early](#calibre_link-956)模式，否则`Header`指令将在应答最后被发送到网络前处理。这意味着可以设置和改写绝大多数应答头，除了自己添加的应答头。
## RequestHeader 指令
| [说明](#calibre_link-18) | 配置HTTP请求头 |
| --- | --- |
| [语法](#calibre_link-19) | `RequestHeader set|append|add|unset header [value] [early|env=[!]variable]` |
| [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess |
| [覆盖项](#calibre_link-66) | FileInfo |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_headers |
| [兼容性](#calibre_link-137) | 仅在 Apache 2.0 中有效 |
这个指令可以替换、合并、删除HTTP应答头。请求头将会在内容处理器运行之前被修改。修改的动作由第一个参数决定，其取值范围如下：
`set`
设置新的或修改已经存在的同名请求头。
`append`
向同名请求头添加新内容而不修改原来已经存在的旧内容。当向一个已经存在的头添加新值时，将用逗号与原来已经存在的旧值分开。这是向HTTP头赋以多个值的标准方法。
`add`
向请求中添加新的头而不修改原来已经存在的头(即使同名)。这将可能导致有两个或更多的请求头具有相同的名字，从而导致意想不到的后果，所以通常不使用这种方法而用`append`来代替它。
`unset`
去除请求中同名的头(若存在的话)。如果有多个头同名，则会被全部去除。value必须被省略。
这些参数后面必须要跟一个header名(结尾的冒号可要可不要，且大小写无关)。对于`add`, `append`, `set`来说，value是第三个参数。如果value包含空格则必须用双引号(")括起来。对于`unset`来说则不需要value参数。value可以是一个普通字符串或包含格式说明符的字符串，格式字符串的用法与`Header`指令一样。
`RequestHeader`后面可以跟一个用于指定生效条件的额外参数(或者用`early`表示"[前处理](#calibre_link-956)")。如果在"`env=...`"参数中指定的[环境变量](#calibre_link-232)存在(或用"`env=!...`"表示不存在)，那么`RequestHeader`指令指定的动作将会生效，否则将不会生效。
除非使用[early](#calibre_link-956)模式，否则`RequestHeader`将在请求被处理之前生效。这样，由浏览器和Apache输入过滤器产生的请求头都可以被该指令处理。
- Apache HTTP Server Version 2.2 文档 [最后更新：2006年3月21日]
- 版本说明
- 从1.3升级到2.0
- 从2.0升级到2.2
- Apache 2.2 新特性概述
- Apache 2.0 新特性概述
- The Apache License, Version 2.0
- 参考手册
- 编译与安装
- 启动Apache
- 停止和重启
- 配置文件
- 配置段(容器)
- 缓冲指南
- 服务器全局配置
- 日志文件
- 从URL到文件系统的映射
- 安全方面的提示
- 动态共享对象(DSO)支持
- 内容协商
- 自定义错误响应
- 地址和端口的绑定(Binding)
- 多路处理模块
- Apache的环境变量
- Apache处理器的使用
- 过滤器(Filter)
- suEXEC支持
- 性能方面的提示
- URL重写指南
- Apache虚拟主机文档
- 基于主机名的虚拟主机
- 基于IP地址的虚拟主机
- 大批量虚拟主机的动态配置
- 虚拟主机示例
- 深入研究虚拟主机的匹配
- 文件描述符限制
- 关于DNS和Apache
- 常见问题
- 经常问到的问题
- Apache的SSL/TLS加密
- SSL/TLS高强度加密：绪论
- SSL/TLS高强度加密：兼容性
- SSL/TLS高强度加密：如何...?
- SSL/TLS Strong Encryption: FAQ
- 如何.../指南
- 认证、授权、访问控制
- CGI动态页面
- 服务器端包含入门
- .htaccess文件
- 用户网站目录
- 针对特定平台的说明
- 在Microsoft Windows中使用Apache
- 在Microsoft Windows上编译Apache
- Using Apache With Novell NetWare
- Running a High-Performance Web Server on HPUX
- The Apache EBCDIC Port
- 服务器和支持程序
- httpd - Apache超文本传输协议服务器
- ab - Apache HTTP服务器性能测试工具
- apachectl - Apache HTTP服务器控制接口
- apxs - Apache 扩展工具
- configure - 配置源代码树
- dbmmanage - 管理DBM格式的用户认证文件
- htcacheclean - 清理磁盘缓冲区
- htdbm - 操作DBM密码数据库
- htdigest - 管理用于摘要认证的用户文件
- httxt2dbm - 生成RewriteMap指令使用的dbm文件
- htpasswd - 管理用于基本认证的用户文件
- logresolve - 解析Apache日志中的IP地址为主机名
- rotatelogs - 滚动Apache日志的管道日志程序
- suexec - 在执行外部程序之前切换用户
- 其他程序
- 杂项文档
- 与Apache相关的标准
- Apache模块
- 描述模块的术语
- 描述指令的术语
- Apache核心(Core)特性
- Apache MPM 公共指令
- Apache MPM beos
- Apache MPM event
- Apache MPM netware
- Apache MPM os2
- Apache MPM prefork
- Apache MPM winnt
- Apache MPM worker
- Apache模块 mod_actions
- Apache模块 mod_alias
- Apache模块 mod_asis
- Apache模块 mod_auth_basic
- Apache模块 mod_auth_digest
- Apache模块 mod_authn_alias
- Apache模块 mod_authn_anon
- Apache模块 mod_authn_dbd
- Apache模块 mod_authn_dbm
- Apache模块 mod_authn_default
- Apache模块 mod_authn_file
- Apache模块 mod_authnz_ldap
- Apache模块 mod_authz_dbm
- Apache模块 mod_authz_default
- Apache模块 mod_authz_groupfile
- Apache模块 mod_authz_host
- Apache模块 mod_authz_owner
- Apache模块 mod_authz_user
- Apache模块 mod_autoindex
- Apache模块 mod_cache
- Apache模块 mod_cern_meta
- Apache模块 mod_cgi
- Apache模块 mod_cgid
- Apache模块 mod_charset_lite
- Apache模块 mod_dav
- Apache模块 mod_dav_fs
- Apache模块 mod_dav_lock
- Apache模块 mod_dbd
- Apache模块 mod_deflate
- Apache模块 mod_dir
- Apache模块 mod_disk_cache
- Apache模块 mod_dumpio
- Apache模块 mod_echo
- Apache模块 mod_env
- Apache模块 mod_example
- Apache模块 mod_expires
- Apache模块 mod_ext_filter
- Apache模块 mod_file_cache
- Apache模块 mod_filter
- Apache模块 mod_headers
- Apache模块 mod_ident
- Apache模块 mod_imagemap
- Apache模块 mod_include
- Apache模块 mod_info
- Apache模块 mod_isapi
- Apache模块 mod_ldap
- Apache模块 mod_log_config
- Apache模块 mod_log_forensic
- Apache模块 mod_logio
- Apache模块 mod_mem_cache
- Apache模块 mod_mime
- Apache模块 mod_mime_magic
- Apache模块 mod_negotiation
- Apache模块 mod_nw_ssl
- Apache模块 mod_proxy
- Apache模块 mod_proxy_ajp
- Apache模块 mod_proxy_balancer
- Apache模块 mod_proxy_connect
- Apache模块 mod_proxy_ftp
- Apache模块 mod_proxy_http
- Apache模块 mod_rewrite
- Apache模块 mod_setenvif
- Apache模块 mod_so
- Apache模块 mod_speling
- Apache模块 mod_ssl
- Apache模块 mod_status
- Apache模块 mod_suexec
- Apache模块 mod_unique_id
- Apache模块 mod_userdir
- Apache模块 mod_usertrack
- Apache模块 mod_version
- Apache模块 mod_vhost_alias
- Developer Documentation for Apache 2.0
- Apache 1.3 API notes
- Debugging Memory Allocation in APR
- Documenting Apache 2.0
- Apache 2.0 Hook Functions
- Converting Modules from Apache 1.3 to Apache 2.0
- Request Processing in Apache 2.0
- How filters work in Apache 2.0
- Apache 2.0 Thread Safety Issues
- 词汇和索引
- 词汇表
- 指令索引
- 指令速查
- 模块索引
- 站点导航