mirror of
https://github.com/apache/httpd.git
synced 2025-05-19 02:21:09 +03:00
8a147876e2
This is the end of this pass for the online manual. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78228 13f79535-47bb-0310-9956-ffa450edef68
105 lines
3.3 KiB
HTML
105 lines
3.3 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<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"
|
|
>
|
|
<!--#include virtual="header.html" -->
|
|
<h1 ALIGN="CENTER">Headers Module</h1>
|
|
|
|
The optional headers module allows for the customization of HTTP
|
|
response headers. Headers can be merged, replaced or removed. The
|
|
directives described in this document are only available if Apache is
|
|
compiled with <b>mod_headers.c</b>.
|
|
|
|
<hr>
|
|
|
|
<h2>Directive</h2>
|
|
<ul>
|
|
<li><A HREF="#header">Header</A>
|
|
</ul>
|
|
|
|
<hr>
|
|
|
|
<h2><A name="header">Header</A></h2>
|
|
<strong>Syntax:</strong> Header [ set | append | add ] <em>header</em> <em>value</em><br>
|
|
<strong>Syntax:</strong> Header unset <em>header</em><br>
|
|
<strong>Context:</strong> server config, virtual host, access.conf, .htaccess<br>
|
|
<strong>Status:</strong> optional<br>
|
|
<strong>Module:</strong> mod_header<p>
|
|
|
|
This directive can replace, merge or remove HTTP response headers. The
|
|
action it performs is determined by the first argument. This can be one
|
|
of the following values:
|
|
|
|
<ul>
|
|
<li><b>set</b><br>
|
|
The response header is set, replacing any previous header with this name
|
|
|
|
<li><b>append</b><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><b>add</b><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><b>unset</b><br>
|
|
The response header of this name is removed, if it exists. If there are
|
|
multiple headers of the same name, only the first one set will be removed.
|
|
</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:
|
|
<ol>
|
|
<li>main server
|
|
<li>virtual host
|
|
<li><Directory> sections and .htaccess
|
|
<li><Location>
|
|
<li><Files>
|
|
</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>
|
|
|
|
<!--#include virtual="footer.html" -->
|
|
</BODY>
|
|
</HTML>
|