<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1586470:1587098 (outdated) -->
+<!-- English Revision: 1588748 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Header append Cache-Control s-maxage=600 "expr=%{REQUEST_STATUS} == 200"
</highlight>
</li>
+
</ol>
</section>
<name>RequestHeader</name>
<description>Configure les en-têtes d'une requête HTTP</description>
<syntax>RequestHeader add|append|edit|edit*|merge|set|setifempty|unset
-<var>en-tête</var> [<var>valeur</var>] [<var>remplacement</var>]
+<var>en-tête</var> [[expr=]<var>valeur</var>] [<var>remplacement</var>]
[early|env=[!]<var>variable</var>]|expr=<var>expression</var>]
</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>SetIfEmpty est disponible depuis la version 2.4.7 du
-serveur HTTP Apache</compatibility>
+serveur HTTP Apache ; le paramètre expr= valeur a été introduit avec la
+version 2.4.10</compatibility>
<usage>
<p>Cette directive permet de remplacer, fusionner, modifier ou
méthode HTTP standard permettant d'affecter plusieurs valeurs à un
en-tête.</dd>
+ <dt><code>edit</code></dt>
<dt><code>edit*</code></dt>
<dd>Si l'en-tête existe, sa valeur est modifiée en fonction d'une
<glossary ref="regex">expression rationnelle</glossary> de type
<dt><code>setifempty</code></dt>
<dd>L'en-tête est défini, mais seulement s'il n'existe
- aucun en-tête avec le même nom. Disponible depuis la
- version 2.4.7 du serveur HTTP Apache.</dd>
+ aucun en-tête avec le même nom.<br />
+ Disponible depuis la version 2.4.7 du serveur HTTP Apache.</dd>
<dt><code>unset</code></dt>
<dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
<name>Header</name>
<description>Configure les en-têtes d'une réponse HTTP</description>
<syntax>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|setifempty|unset|note
-<var>en-tête</var> [<var>valeur</var>] [<var>remplacement</var>]
+<var>en-tête</var> [[expr=]<var>valeur]</var>] [<var>remplacement</var>]
[early|env=[!]<var>variable</var>]|expr=<var>expression</var>]
</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
-<compatibility>La condition par défaut est temporairement passée
-à "always" dans les version 2.3.9 et 2.3.10. SetIfEmpty est
-disponible depuis la version 2.4.7 du serveur HTTP Apache.</compatibility>
+<compatibility>SetIfEmpty est disponible depuis la version 2.4.7 du
+serveur HTTP Apache ; le paramètre expr= valeur a été introduit avec la
+version 2.4.10</compatibility>
<usage>
<p>Cette directive permet de remplacer, fusionner, ou
l'en-tête original a été défini. La table qui correspond à
<code>always</code> est utilisée pour les réponses d'erreur générées
localement ainsi que pour les réponses qui ont abouti.
- Notez aussi que la répétition
+ Notez aussi que la répétition
de cette directive avec les deux conditions peut être pertinente
dans certains scénarios, car <code>always</code> n'englobe pas
<code>onsuccess</code> en ce qui concerne les en-têtes existants :</p>
<ul>
<li>Vous ajoutez un en-tête à une réponse
- générée localement et échouée
- (non-2xx),
+ générée localement et échouée (non-2xx),
une redirection par exemple, et dans ce cas, seule la table
correspondant à <code>always</code> est utilisée dans la réponse
définitive.</li>
<glossary ref="regex">expression rationnelle</glossary>, et
l'argument <var>remplacement</var> une chaîne de caractères de
remplacement qui peut contenir des références
- arrières ou des spécificateurs de format. La forme
- <code>edit</code> n'effectuera une
+ arrières ou des spécificateurs de format. La forme <code>edit</code> n'effectuera une
recherche/remplacement qu'une seule fois dans la valeur de
l'en-tête, alors que la forme <code>edit*</code> en effectuera autant
que le nombre d'apparition de la chaîne à remplacer.</dd>
<dt><code>setifempty</code></dt>
<dd>L'en-tête est défini, mais seulement s'il n'existe
- aucun en-tête avec le même nom. Disponible depuis la
- version 2.4.7 du serveur HTTP Apache.</dd>
+ aucun en-tête avec le même nom.<br />
+ Disponible depuis la version 2.4.7 du serveur HTTP Apache.</dd>
<dt><code>unset</code></dt>
<dd>L'en-tête est supprimé s'il existe. Si plusieurs en-têtes
<dt><code>note</code></dt>
<dd>La valeur de l'<var>en-tête</var> considéré est copiée dans une
note interne dont le nom est spécifié via l'argument
- <var>valeur</var>. Ceci permet d'enregistrer la valeur d'un en-tête
+ <var>valeur</var>. Ceci permet de journaliser la valeur d'un en-tête
envoyé par un programme CGI ou une ressource mandatée, même s'il
- est prévu de l'effacer.</dd>
+ est prévu de l'effacer.<br />
+ Disponible à partir de la version 2.4.7 du serveur HTTP Apache.</dd>
- </dl>
+ </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
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>
+ format propres à <module>mod_headers</module> (et des caractères
+ littéraux), ou une expression <a href="../expr.html">ap_expr</a>
+ préfixée par <em>expr=</em>.</p>
+
+ <p><var>valeur</var> supporte les spécificateurs de format suivants :</p>
<table border="1" style="zebra">
<columnspec><column width=".25"/><column width=".75"/></columnspec>
valeur est exprimée en microsecondes.</td></tr>
<tr><td><code>%l</code></td>
- <td>La charge courante du serveur. Ce sont les valeurs fournies
- par <code>getloadavg()</code> qui représentent la charge
- courante, ainsi que la charge moyenne pendant les cinq et les
- quinze dernières minutes. Chaque valeur est précédée de
- <code>l=</code> et séparée des autres par un slash
- <code>/</code>.<br />
+ <td>La charge moyenne courante du serveur proprement dit. Ce
+ sont les valeurs obtenues par <code>getloadavg()</code> qui
+ représentent la charge moyenne courante, sur 5 minutes et sur 15
+ minutes. Chaque valeur est précédée de <code>l=</code> et
+ séparée de la suivante par un <code>/</code>.<br />
Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<tr><td><code>%i</code></td>
- <td>Le pourcentage de disponibilité de httpd (0 à 100) basé sur
- le nombre de threads et de processus disponibles. La valeur est
- précédée de <code>i=</code>.<br />
+ <td>Le pourcentage courant de httpd au repos (de 0 à 100)
+ en se basant sur le nombre de processus et threads disponibles.
+ La valeur est précédée de <code>i=</code>.<br />
Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<tr><td><code>%b</code></td>
- <td>Le pourcentage d'utilisation de httpd (0 à 100) basé sur
- le nombre de threads et de processus disponibles. La valeur est
- précédée de <code>b=</code>.<br />
+ <td>Le pourcentage courant de httpd utilisé (de 0 à 100)
+ en se basant sur le nombre de processus et threads disponibles.
+ La valeur est précédée de <code>b=</code>.<br />
Disponible depuis la version 2.4.4 du serveur HTTP Apache.
</td></tr>
<var>valeur</var>, qui est une <glossary ref="regex">expression
rationnelle</glossary>, et une chaîne additionnelle
<var>remplacement</var>. Depuis la version 2.4.7, la chaîne de
- remplacement peut aussi contenir des spécificateurs de format.</p>
+ remplacement peut aussi
+ contenir des spécificateurs de format.</p>
<p>La directive <directive>Header</directive> peut être suivie d'un
argument additionnel qui peut prendre les valeurs suivantes :</p>
directives <directive>Header</directive> 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 certains en-têtes qui sont ajoutés par le filtre
+ l'exception de certains en-têtes qui sont ajoutés par le filtre
d'en-tête HTTP. Avant la version 2.2.12, il n'était pas
possible de modifier l'en-tête Content-Type avec cette directive.</p>
</usage>
projects / apache / commitdiff