| Current Path : /usr/local/share/doc/apache/mod/ |
FreeBSD hs32.drive.ne.jp 9.1-RELEASE FreeBSD 9.1-RELEASE #1: Wed Jan 14 12:18:08 JST 2015 root@hs32.drive.ne.jp:/sys/amd64/compile/hs32 amd64 |
| Current File : //usr/local/share/doc/apache/mod/mod_headers.html |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>Apache module mod_headers</title>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#000080" alink="#FF0000">
<div align="CENTER">
<img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
<h3>Apache HTTP Server Version 1.3</h3>
<p><small><em>Is this the version you want? For more recent
versions, check our <a href="/docs/">documentation
index</a>.</em></small></p>
</div>
<h1 align="CENTER">Module mod_headers</h1>
<p>This module provides for the customization of HTTP response
headers.</p>
<p><a href="module-dict.html#Status"
rel="Help"><strong>Status:</strong></a> Extension<br />
<a href="module-dict.html#SourceFile"
rel="Help"><strong>Source File:</strong></a>
mod_headers.c<br />
<a href="module-dict.html#ModuleIdentifier"
rel="Help"><strong>Module Identifier:</strong></a>
headers_module<br />
<a href="module-dict.html#Compatibility"
rel="Help"><strong>Compatibility:</strong></a> Available in
Apache 1.2 and later.</p>
<h2>Summary</h2>
This module provides a directive to control the sending of HTTP
headers. Headers can be merged, replaced or removed.
<h2>Directives</h2>
<ul>
<li><a href="#header">Header</a></li>
<li><a href="#errorheader">ErrorHeader</a></li>
</ul>
<hr />
<h2><a id="header" name="header">Header</a> directive</h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> Header set|append|add
<em>header</em> <em>value</em><br />
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> Header unset
<em>header</em><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> server config, virtual
host, access.conf, .htaccess<br />
<a href="directive-dict.html#Override"
rel="Help"><strong>Override:</strong></a> FileInfo<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> Extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_headers
<p>This directive can replace, merge or remove HTTP response
headers during 1xx and 2xx series replies. For 3xx, 4xx and 5xx
use the ErrorHeader directive.
</p>
<p>
The action it performs is determined by the first
argument. This can be one of the following values:</p>
<ul>
<li><strong>set</strong><br />
The response header is set, replacing any previous header
with this name</li>
<li><strong>append</strong><br />
The response header is appended to any existing header of
the same name. When a new value is merged onto an existing
header it is separated from the existing header with a comma.
This is the HTTP standard way of giving a header multiple
values.</li>
<li><strong>add</strong><br />
The response header is added to the existing set of headers,
even if this header already exists. This can result in two
(or more) headers having the same name. This can lead to
unforeseen consequences, and in general "append" should be
used instead.</li>
<li><strong>unset</strong><br />
The response header of this name is removed, if it exists.
If there are multiple headers of the same name, all will be
removed.</li>
</ul>
This argument is followed by a header name, which can include
the final colon, but it is not required. Case is ignored. For
add, append and set a value is given as the third argument. If
this value contains spaces, it should be surrounded by double
quotes. For unset, no value should be given.
<h3>Order of Processing</h3>
The Header directive can occur almost anywhere within the
server configuration. It is valid in the main server config and
virtual host sections, inside <Directory>,
<Location> and <Files> sections, and within
.htaccess files.
<p>The Header directives are processed in the following
order:</p>
<ol>
<li>main server</li>
<li>virtual host</li>
<li><Directory> sections and .htaccess</li>
<li><Location></li>
<li><Files></li>
</ol>
Order is important. These two headers have a different effect
if reversed:
<pre>
Header append Author "John P. Doe"
Header unset Author
</pre>
This way round, the Author header is not set. If reversed, the
Author header is set to "John P. Doe".
<p>The Header directives are processed just before the response
is sent by its handler. These means that some headers that are
added just before the response is sent cannot be unset or
overridden. This includes headers such as "Date" and
"Server".</p>
<h2><a id="errorheader" name="errorheader">ErrorHeader</a> directive</h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> ErrorHeader set|append|add
<em>header</em> <em>value</em><br />
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> ErrorHeader unset
<em>header</em><br />
<a href="directive-dict.html#Context"
rel="Help"><strong>Context:</strong></a> server config, virtual
host, access.conf, .htaccess<br />
<a href="directive-dict.html#Override"
rel="Help"><strong>Override:</strong></a> FileInfo<br />
<a href="directive-dict.html#Status"
rel="Help"><strong>Status:</strong></a> Extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> mod_headers
<p>This directive can replace, merge or remove HTTP response
headers on all replies including errors, redirects, and successful
responses. To add headers only on sucessful (status 2xx) responses,
use the Header directive.
</p>
<p>This directive is identical to the <a href="#header">Header</a>
directive in all other respects. Consult this directive for
more information on the syntax.
</P>
<p> <hr />
<h3 align="CENTER">Apache HTTP Server Version 1.3</h3>
<a href="./"><img src="../images/index.gif" alt="Index" /></a>
<a href="../"><img src="../images/home.gif" alt="Home" /></a>
</p>
</body>
</html>