mod_headers.html.fr revision 70f5253b24dd333c67fb6502d557a8b48ad3ba87
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_headers - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="/images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_headers</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/mod_headers.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Personnalisation des en-t�tes de requ�tes et de r�ponses
HTTP</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>headers_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_headers.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module fournit des directives permettant de contr�ler et
modifier les en-t�tes de requ�tes et de r�ponses HTTP. Les en-t�tes
peuvent �tre fusionn�s, remplac�s ou supprim�s.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="/images/down.gif" /> <a href="#header">Header</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#requestheader">RequestHeader</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="/images/down.gif" /> <a href="#order">Chronologie du traitement</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#early">Traitement pr�coce et traitement
tardif</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="order" id="order">Chronologie du traitement</a></h2>
<p>Les directives fournies par <code class="module"><a href="/mod/mod_headers.html">mod_headers</a></code> peuvent
s'ins�rer presque partout dans la configuration du serveur, et on
peut limiter leur port�e en les pla�ant dans des <a href="/sections.html">sections de configuration</a>.</p>
<p>La chronologie du traitement est importante et est affect�e par
l'ordre d'apparition des directives dans le fichier de configuration
et par leur placement dans les <a href="/sections.html#mergin">sections de configuration</a>. Ainsi,
ces deux directives ont un effet diff�rent si leur ordre est invers�
:</p>
<div class="example"><p><code>
RequestHeader append MirrorID "mirror 12"<br />
RequestHeader unset MirrorID
</code></p></div>
<p>Dans cet ordre, l'en-t�te <code>MirrorID</code> n'est pas d�fini.
Si l'ordre des directives �tait invers�, l'en-t�te
<code>MirrorID</code> serait d�fini � "mirror 12".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="early" id="early">Traitement pr�coce et traitement
tardif</a></h2>
<p><code class="module"><a href="/mod/mod_headers.html">mod_headers</a></code> peut agir soir pr�cocement, soit
tardivement au niveau de la requ�te. Le mode normal est le mode
tardif, lorsque les en-t�tes de <em>requ�te</em> sont d�finis, imm�diatement
avant l'ex�cution du g�n�rateur de contenu, et pour les en-t�tes de
<em>r�ponse</em>, juste au moment o� la r�ponse est envoy�e sur le r�seau.
Utilisez toujours le mode tardif sur un serveur en production.</p>
<p>Le mode pr�coce a �t� con�u � des fins d'aide aux tests et au
d�bogage pour les d�veloppeurs. Les directives d�finies en utilisant
le mot-cl� <code>early</code> sont cens�es agir au tout d�but du
traitement de la requ�te. Cela signifie que l'on peut les utiliser
pour simuler diff�rentes requ�tes et d�finir des situations de test,
tout en gardant � l'esprit que les en-t�tes peuvent �tre modifi�s �
tout moment par d'autres modules avant que le r�ponse ne soit
g�n�r�e.</p>
<p>Comme les directives pr�coces sont trait�es avant que le
chemin de la requ�te ne soit parcouru, les en-t�tes
pr�coces ne peuvent �tre d�finis que dans un contexte de serveur
principal ou de serveur virtuel. Les directives pr�coces ne peuvent
pas d�pendre d'un chemin de requ�te, si bien qu'elles �choueront
dans des contextes tels que <code>&lt;Directory&gt;</code> ou
<code>&lt;Location&gt;</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">Exemples</a></h2>
<ol>
<li>
Copie tous les en-t�tes de requ�te qui commencent par "TS" vers
les en-t�tes de la r�ponse :
<div class="example"><p><code>
Header echo ^TS
</code></p></div>
</li>
<li>
Ajoute � la r�ponse un en-t�te, <code>mon-en-t�te</code>, qui
contient un horodatage permettant de d�terminer le moment o� la
requ�te a �t� re�ue, et le temps qui s'est �coul� jusqu'� ce que
la requ�te ait commenc� � �tre servie. Cet en-t�te peut �tre
utilis� par le client pour estimer la charge du serveur ou
isoler les goulets d'�tranglement entre le client et le
serveur.
<div class="example"><p><code>
Header set mon-en-t�te "%D %t"
</code></p></div>
<p>le r�sultat est l'ajout � la r�ponse d'un en-t�te du type :</p>
<div class="example"><p><code>
mon-en-t�te: D=3775428 t=991424704447256
</code></p></div>
</li>
<li>
Dit Bonjour � Joe
<div class="example"><p><code>
Header set mon-en-t�te "Bonjour Joe. Il a fallu %D microsecondes \<br />
� Apache pour servir cette requ�te."
</code></p></div>
<p>le r�sultat est l'ajout � la r�ponse d'un en-t�te du type :</p>
<div class="example"><p><code>
mon-en-t�te: Bonjour Joe. Il a fallu D=3775428 microsecondes � Apache
pour servir cette requ�te.
</code></p></div>
</li>
<li>
Ajoute l'en-t�te <code>mon-en-t�te</code> � la r�ponse si et
seulement si l'en-t�te <code>mon-en-t�te-requ�te</code> est
pr�sent dans la requ�te. Ceci peut s'av�rer utile pour g�n�rer
des en-t�tes de r�ponse "� la t�te du client". Notez que cet
exemple n�cessite les services du module
<code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code>.
<div class="example"><p><code>
SetEnvIf mon-en-t�te-requ�te mavaleur HAVE_MyRequestHeader<br />
Header set mon-en-t�te "%D %t montexte" env=HAVE_MyRequestHeader
</code></p></div>
<p>Si l'en-t�te <code>mon-en-t�te-requ�te: mavaleur</code> est
pr�sent dans la requ�te HTTP, la r�ponse contiendra un en-t�te
du type :</p>
<div class="example"><p><code>
mon-en-t�te: D=3775428 t=991424704447256 montexte
</code></p></div>
</li>
<li>
Permet � DAV de fonctionner avec Apache sur SSL (voir la <a href="http://svn.haxx.se/users/archive-2006-03/0549.shtml">description
du probl�me</a>) en rempla�ant <var>https:</var> par
<var>http:</var> dans l'en-t�te <var>Destination</var> :
<div class="example"><p><code>
RequestHeader edit Destination ^https: http: early
</code></p></div>
</li>
<li>
D�finit la valeur d'un m�me en-t�te sous de multiples conditions
non exclusives, mais ne duplique pas une valeur d�j� d�finie
dans l'en-t�te qui en r�sulte. Si toutes les conditions
suivantes sont satisfaites pour une requ�te (en d'autres termes,
si les trois variables d'environnement <code>CGI</code>,
<code>NO_CACHE</code> et <code>NO_STORE</code> existent pour la
requ�te) :
<div class="example"><p><code>
Header merge Cache-Control no-cache env=CGI<br />
Header merge Cache-Control no-cache env=NO_CACHE<br />
Header merge Cache-Control no-store env=NO_STORE
</code></p></div>
<p>alors, la r�ponse contiendra l'en-t�te suivant :</p>
<div class="example"><p><code>
Cache-Control: no-cache, no-store
</code></p></div>
<p>Si <code>append</code> avait �t� utilis� � la place de
<code>merge</code>, la r�ponse aurait contenu l'en-t�te suivant
:</p>
<div class="example"><p><code>
Cache-Control: no-cache, no-cache, no-store
</code></p></div>
</li>
<li>
D�finit un cookie de test si et seulement si le client n'envoie
pas de cookie
<div class="example"><p><code>
Header set Set-Cookie testcookie !$req{Cookie}
</code></p></div>
</li>
</ol>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Header" id="Header">Header</a> <a name="header" id="header">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-t�tes d'une r�ponse HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|merge|set|unset
<var>en-t�te</var> [<var>valeur</var>] [early|env=[!]<var>variable</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La condition par d�faut passe de "onsuccess" � "always" �
partir de la version 2.3.9</td></tr>
</table>
<p>Cette directive permet de remplacer, fusionner, ou
supprimer des en-t�tes de r�ponse HTTP. L'en-t�te est modifi� juste
apr�s que le gestionnaire de contenu et les filtres en sortie ne
s'ex�cutent, ce qui permet la modification des en-t�tes
sortants.</p>
<p>A partir de la version 2.3.9, la condition par d�faut est
"always", ce qui implique que cette directive agit sans tenir compte
du code d'�tat de la r�ponse. Dans les versions 2.3.8 et
ant�rieures, "onsuccess" �tait la condition par d�faut, ce qui
impliquait que les en-t�tes n'�taient modifi�s que pour les r�ponses
avec code d'�tat <code>2<var>xx</var></code>.</p>
<p>Une valeur effective <code>always</code> peut �tre n�cessaire
pour forcer la d�finition des en-t�tes par certains modules internes
(tels que <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>), m�me dans le cas de r�ponses
positives, et doit toujours �tre pr�sente pour modifier les r�ponses avec un code
d'�tat autre que <code>2<var>xx</var></code>, comme les redirections
ou les erreurs clients.</p>
<p>L'action que cette directive provoque est d�termin�e par le
premier argument (ou par le second argument si une
<var>condition</var> est sp�cifi�e). Il peut prendre
une des valeurs suivantes :</p>
<dl>
<dt><code>add</code></dt>
<dd>L'en-t�te est ajout� au jeu d'en-t�tes pr�existant, m�me s'il
existe d�j�. Ceci peut conduire � la pr�sence de deux (ou plusieurs)
en-t�tes poss�dant le m�me nom et donc induire des cons�quences
impr�vues ; en g�n�ral, il est pr�f�rable d'utiliser
<code>set</code>, <code>append</code> ou <code>merge</code>.</dd>
<dt><code>append</code></dt>
<dd>La valeur d'en-t�te est ajout�e � tout en-t�te existant de m�me
nom. Lorsqu'une nouvelle valeur est ainsi ajout�e, elle est s�par�e
de celles qui sont d�j� pr�sentes par une virgule. Il s'agit de la
m�thode HTTP standard permettant d'affecter plusieurs valeurs � un
en-t�te.</dd>
<dt><code>echo</code></dt>
<dd>Les en-t�tes de la requ�te poss�dant le nom sp�cifi� sont
recopi�s vers les en-t�tes de la r�ponse. <var>en-t�te</var> peut
�tre une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
<var>valeur</var> ne doit pas �tre pr�sent.</dd>
<dt><code>edit</code></dt>
<dd>Si l'en-t�te existe, sa valeur est modifi�e en fonction d'une
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type
recherche/remplacement. L'argument <var>valeur</var> est une
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
l'argument <var>remplacement</var> une cha�ne de caract�res de
remplacement qui peut contenir des r�f�rences arri�res.</dd>
<dt><code>merge</code></dt>
<dd>La valeur d'en-t�te est ajout�e � tout en-t�te de m�me nom, sauf
si elle appara�t d�j� dans la liste des valeurs pr�existantes de
l'en-t�te s�par�es par des virgules. Lorsqu'une nouvelle valeur est
ainsi ajout�e, elle est s�par�e de celles qui sont d�j� pr�sentes
par une virgule. Il s'agit de la m�thode HTTP standard permettant
d'affecter plusieurs valeurs � un en-t�te. Les valeurs sont
compar�es en tenant compte de la casse, et apr�s le traitement de
tous les sp�cificateurs de format. Une valeur entour�e de guillemets
est consid�r�e comme diff�rente de la m�me valeur mais sans
guillemets.</dd>
<dt><code>set</code></dt>
<dd>L'en-t�te est d�fini, rempla�ant tout en-t�te pr�existant avec
le m�me nom. L'argument <var>valeur</var> peut �tre une cha�ne de
formatage.</dd>
<dt><code>unset</code></dt>
<dd>L'en-t�te est supprim� s'il existe. Si plusieurs en-t�tes
poss�dent le m�me nom, ils seront tous supprim�s. L'argument
<var>value</var> ne doit pas appara�tre.</dd>
</dl>
<p>Cet argument est suivi d'un nom d'<var>en-t�te</var> qui peut se
terminer par un caract�re ':', mais ce n'est pas obligatoire. La
casse est ignor�e avec <code>set</code>, <code>append</code>,
<code>merge</code>, <code>add</code>, <code>unset</code> et
<code>edit</code>. Le nom d'<var>en-t�te</var> est sensible � la
casse pour <code>echo</code> et peut �tre une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p>
<p>Avec <code>set</code>, <code>append</code>, <code>merge</code> et
<code>add</code>, une <var>valeur</var> est sp�cifi�e comme
argument suivant. Si <var>valeur</var> contient des espaces, elle
doit �tre entour�e de guillemets. <var>valeur</var> peut �tre une
cha�ne de caract�res, une cha�ne contenant des sp�cificateurs de
format, ou une combinaison des deux. <var>valeur</var> supporte les
sp�cificateurs de format suivants :</p>
<table class="bordered"><tr class="header"><th>Format</th><th>Description</th></tr>
<tr><td><code>%%</code></td>
<td>Le caract�re pourcentage</td></tr>
<tr class="odd"><td><code>%t</code></td>
<td>Le moment de r�ception de la requ�te en temps
universel coordonn� depuis le temps epoch (Jan. 1, 1970) et
exprim� en microsecondes. La valeur est pr�c�d�e de
<code>t=</code>.</td></tr>
<tr><td><code>%D</code></td>
<td>Le temps �coul� entre la r�ception de la requ�te et l'envoi
des en-t�tes sur le r�seau. Il s'agit de la dur�e de traitement
de la requ�te. La valeur est pr�c�d�e de <code>D=</code>. La
valeur est exprim�e en microsecondes.</td></tr>
<tr class="odd"><td><code>%{NOM_VARIABLE}e</code></td>
<td>Le contenu de la <a href="/env.html">variable
d'environnement</a> <code>NOM_VARIABLE</code>.</td></tr>
<tr><td><code>%{NOM_VARIABLE}s</code></td>
<td>Le contenu de la <a href="/env.html">variable
d'environnement SSL</a> <code>NOM_VARIABLE</code>, si
<code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> est activ�.</td></tr>
</table>
<div class="note"><h3>Note</h3>
<p>Le sp�cificateur de format <code>%s</code> est disponible
depuis la version 2.1 d'Apache ; il peut �tre utilis� � la place
de <code>%e</code> pour �viter de devoir sp�cifier
<code>SSLOptions +StdEnvVars</code>. Cependant, si
<code>SSLOptions +StdEnvVars</code> doit tout de m�me �tre
sp�cifi� pour une raison quelconque, <code>%e</code> sera plus
efficace que <code>%s</code>.</p>
</div>
<p><code>edit</code>n�cessite les deux arguments
<var>valeur</var>, qui est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression
rationnelle</a>, et une cha�ne additionnelle
<var>remplacement</var>.</p>
<p>La directive <code class="directive">Header</code> peut �tre suivie d'un
argument additionnel qui peut prendre les valeurs suivantes :</p>
<dl>
<dt><code>early</code></dt>
<dd>Sp�cifie <a href="#early">traitement pr�alable</a>.</dd>
<dt><code>env=[!]variable</code></dt>
<dd>La directive est appliqu�e si et seulement si la <a href="/env.html">variable d'environnement</a>
<code>variable</code> existe. Un <code>!</code> devant
<code>variable</code> inverse le test, et la directive ne
s'appliquera alors que si <code>variable</code> n'est pas d�finie.</dd>
<dt><code>expr</code></dt>
<dd>Une cha�ne qui correspond � toute valeur ci-dessus est
interpr�t�e comme une expression. Les d�tails � propos de la syntaxe
des expressions et leur �valuation sont pour l'instant mieux
document�s dans la page de <code class="module"><a href="/mod/mod_filter.html">mod_filter</a></code>.</dd>
</dl>
<p>Except� le cas du mode <a href="#early">pr�coce</a>, les
directives <code class="directive">Header</code> sont trait�es juste avant
l'envoi de la r�ponse sur le r�seau. Cela signifie qu'il est
possible de d�finir et/ou modifier la plupart des en-t�tes, �
l'exception de ceux qui sont ajout�s par le filtre HTTP
d'en-t�te, comme Content-Type.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RequestHeader" id="RequestHeader">RequestHeader</a> <a name="requestheader" id="requestheader">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure les en-t�tes d'une requ�te HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RequestHeader add|append|edit|edit*|merge|set|unset <var>en-t�te</var>
[<var>valeur</var>] [<var>remplacement</var>] [early|env=[!]<var>variable</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_headers</td></tr>
</table>
<p>Cette directive permet de remplacer, fusionner, modifier ou
supprimer des en-t�tes de requ�te HTTP. L'en-t�te est modifi� juste
avant que le gestionnaire de contenu ne s'ex�cute, ce qui permet la
modification des en-t�tes entrants. L'action effectu�e est
d�termin�e par le premier argument. Ce dernier accepte les valeurs
suivantes :</p>
<dl>
<dt><code>add</code></dt>
<dd>L'en-t�te est ajout� au jeu d'en-t�tes pr�existant, m�me s'il
existe d�j�. Ceci peut conduire � la pr�sence de deux (ou plusieurs)
en-t�tes poss�dant le m�me nom et donc induire des cons�quences
impr�vues ; en g�n�ral, il est pr�f�rable d'utiliser
<code>set</code>, <code>append</code> ou <code>merge</code>.</dd>
<dt><code>append</code></dt>
<dd>La valeur d'en-t�te est ajout�e � tout en-t�te existant de m�me
nom. Lorsqu'une nouvelle valeur est ainsi ajout�e, elle est s�par�e
de celles qui sont d�j� pr�sentes par une virgule. Il s'agit de la
m�thode HTTP standard permettant d'affecter plusieurs valeurs � un
en-t�te.</dd>
<dt><code>edit*</code></dt>
<dd>Si l'en-t�te existe, sa valeur est modifi�e en fonction d'une
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type
recherche/remplacement. L'argument <var>valeur</var> est une
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>, et
l'argument <var>remplacement</var> une cha�ne de caract�res de
remplacement qui peut contenir des r�f�rences arri�res. Avec
<code>edit</code>, la cha�ne de l'en-t�te correspondant au mod�le ne
sera recherch�e et remplac�e qu'une seule fois, alors qu'avec
<code>edit*</code>, elle le sera pour chacune de ses instances si
elle appara�t plusieurs fois.</dd>
<dt><code>merge</code></dt>
<dd>La valeur d'en-t�te est ajout�e � tout en-t�te de m�me nom, sauf
si elle appara�t d�j� dans la liste des valeurs pr�existantes de
l'en-t�te s�par�es par des virgules. Lorsqu'une nouvelle valeur est
ainsi ajout�e, elle est s�par�e de celles qui sont d�j� pr�sentes
par une virgule. Il s'agit de la m�thode HTTP standard permettant
d'affecter plusieurs valeurs � un en-t�te. Les valeurs sont
compar�es en tenant compte de la casse, et apr�s le traitement de
tous les sp�cificateurs de format. Une valeur entour�e de guillemets
est consid�r�e comme diff�rente de la m�me valeur mais sans
guillemets.</dd>
<dt><code>set</code></dt>
<dd>L'en-t�te est d�fini, rempla�ant tout en-t�te pr�existant avec
le m�me nom.</dd>
<dt><code>unset</code></dt>
<dd>L'en-t�te est supprim� s'il existe. Si plusieurs en-t�tes
poss�dent le m�me nom, ils seront tous supprim�s. L'argument
<var>value</var> ne doit pas appara�tre.</dd>
</dl>
<p>Cet argument est suivi d'un nom d'en-t�te qui peut se terminer
par un caract�re ':', mais ce n'est pas obligatoire. La casse est
ignor�e. Avec <code>set</code>, <code>append</code>,
<code>merge</code> et <code>add</code>, une <var>valeur</var> est
fournie en troisi�me argument. Si une <var>valeur</var> contient des
espaces, elle doit �tre entour�e de guillemets. Avec
<code>unset</code>, aucune <var>valeur</var> ne doit appara�tre.
<var>valeur</var> peut �tre une cha�ne de caract�res, une cha�ne
contenant des sp�cificateurs de format, ou une combinaison des deux.
Les sp�cificateurs de format support�s sont les m�mes que ceux de la
directive <code class="directive"><a href="#header">Header</a></code>, �
laquelle vous pouvez vous reporter pour plus de d�tails. Avec
<code>edit</code>, les deux arguments <var>valeur</var> et
<var>remplacement</var> sont obligatoires, et correspondent
respectivement � une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression
rationnelle</a> et � une cha�ne de remplacement.</p>
<p>La directive <code class="directive">RequestHeader</code> peut �tre
suivie d'un argument suppl�mentaire, qui pourra prendre les valeurs
suivantes :</p>
<dl>
<dt><code>early</code></dt>
<dd>Sp�cifie <a href="#early">traitement pr�alable</a>.</dd>
<dt><code>env=[!]variable</code></dt>
<dd>La directive est appliqu�e si et seulement si la <a href="/env.html">variable d'environnement</a>
<code>variable</code> existe. Un <code>!</code> devant
<code>variable</code> inverse le test, et la directive ne
s'appliquera alors que si <code>variable</code> n'est pas d�finie.</dd>
<dt><code>expr</code></dt>
<dd>Une cha�ne qui correspond � toute valeur ci-dessus est
interpr�t�e comme une expression. Les d�tails � propos de la syntaxe
des expressions et leur �valuation sont pour l'instant mieux
document�s dans la page de <code class="module"><a href="/mod/mod_filter.html">mod_filter</a></code>.</dd>
</dl>
<p>Except� le cas du mode <a href="#early">pr�coce</a>, la directive
<code class="directive">RequestHeader</code> est trait�e juste avant la
prise en compte de la requ�te par son gestionnaire, au cours de la
phase de v�rification. Ceci permet la modification des en-t�tes
g�n�r�s par le navigateur, ou par les filtres en entr�e
d'Apache.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_headers.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/mod_headers.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/mod_headers.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/mod/mod_headers.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>