diff options
Diffstat (limited to 'docs/manual/mod/mod_headers.html.fr')
| -rw-r--r-- | docs/manual/mod/mod_headers.html.fr | 126 |
1 files changed, 76 insertions, 50 deletions
diff --git a/docs/manual/mod/mod_headers.html.fr b/docs/manual/mod/mod_headers.html.fr index 5aac11ac..8f1e7c6f 100644 --- a/docs/manual/mod/mod_headers.html.fr +++ b/docs/manual/mod/mod_headers.html.fr @@ -5,7 +5,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -<title>mod_headers - Serveur Apache HTTP</title> +<title>mod_headers - Serveur Apache HTTP Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> @@ -98,8 +98,7 @@ tardif</a></h2> 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><Directory></code> ou - <code><Location></code>.</p> + dans des contextes tels que <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#location"><Location></a></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> @@ -211,6 +210,13 @@ Header merge Cache-Control no-store env=NO_STORE</pre> <pre class="prettyprint lang-config">Header set Set-Cookie testcookie "expr=-z %{req:Cookie}"</pre> </li> + <li> + Ajoute un en-tête de mise en cache pour les réponses avec un + code d'état HTTP de 200 + <pre class="prettyprint lang-config">Header append Cache-Control s-maxage=600 "expr=%{REQUEST_STATUS} == 200"</pre> + + </li> + </ol> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -218,16 +224,17 @@ Header merge Cache-Control no-store env=NO_STORE</pre> <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|edit*|merge|set|setifempty|unset|note -<var>en-tête</var> [<var>valeur</var>] [<var>remplacement</var>] -[early|env=[!]<var>variable</var>]|expr=<var>expression</var>] +<var>en-tête</var> [[expr=]<var>valeur</var> +[<var>remplacement</var>] +[early|env=[!]<var>variable</var>|expr=<var>expression</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">AllowOverride:</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 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.</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>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</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 @@ -237,24 +244,27 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <p>L'argument optionnel <var>condition</var> permet de déterminer sur quelle table interne d'en-têtes de réponses cette directive va - opérer. D'autres composants du serveur peuvent avoir stocké leurs - en-têtes de réponses dans la table correspondant à - <code>onsuccess</code> ou dans celle correspondant à - <code>always</code>. Dans ce contexte, "Always" fait référence au - choix d'envoyer les en-têtes que vous ajoutez aux réponses, qu'elle - soient avec succès ou échouées ; par contre, si votre action est une - fonction d'un en-tête existant, vous devrez lire la documentation de - manière plus approfondie car dans ce cas, les choses se compliquent.</p> - - <p>Vous pouvez avoir à changer la valeur par défaut - <code>onsuccess</code> en <code>always</code> dans des circonstances - similaires à celles exposées plus loin. Notez aussi que la répétition + opérer. En dépit du nom, la valeur par défaut de + <code>onsuccess</code> ne limite <em>pas</em> une <var>action</var> + aux réponses avec un code d'état de 2xx. Les en-têtes définis sous + cette condition sont encore utilisés quand par exemple une requête + est mandatée ou générée par un programme CGI avec <em>succès</em>, + et ceci même dans le cas où ils ont généré un code d'échec.</p> + + <p>Lorsque votre action est une fonction agissant sur un en-tête + existant, vous pourrez être amené à spécifier une condition + <code>always</code>, en fonction de la table interne dans laquelle + 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 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 échouée (non-2xx), + <li>Vous ajoutez un en-tête à une réponse + 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> @@ -267,6 +277,12 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> condition par défaut <code>onsuccess</code>.</li> </ul> + <p>Outre le paramètre <var>condition</var> décrit ci-dessus, vous + pouvez limiter une action en fonction de codes d'état HTTP, par + exemple pour les requêtes mandatées ou générées par un programme + CGI. Voir l'exemple qui utilise %{REQUEST_STATUS} dans la section + ci-dessus.</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 @@ -301,8 +317,7 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <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 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> @@ -326,8 +341,8 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <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 @@ -337,11 +352,12 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <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 @@ -355,8 +371,11 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> 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 à <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> (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 class="bordered"><tr class="header"><th>Format</th><th>Description</th></tr> <tr><td><code>%%</code></td> @@ -372,22 +391,24 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> 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>%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>. + <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>. + <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 class="odd"><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>. + <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> <tr><td><code>%{NOM_VARIABLE}e</code></td> <td>Le contenu de la <a href="../env.html">variable @@ -412,7 +433,8 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <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>. 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 <code class="directive">Header</code> peut être suivie d'un argument additionnel qui peut prendre les valeurs suivantes :</p> @@ -435,8 +457,9 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> 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> + 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> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -444,15 +467,17 @@ disponible depuis la version 2.4.7 du serveur HTTP Apache.</td></tr> <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|setifempty|unset -<var>en-tête</var> [<var>valeur</var>] [<var>remplacement</var>] -[early|env=[!]<var>variable</var>]|expr=<var>expression</var>] +<var>en-tête</var> [[expr=]<var>valeur</var> +[<var>remplacement</var>] +[early|env=[!]<var>variable</var>|expr=<var>expression</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">AllowOverride:</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>SetIfEmpty est disponible depuis la version 2.4.7 du -serveur HTTP Apache</td></tr> +serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la +version 2.4.10</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 @@ -477,6 +502,7 @@ serveur HTTP Apache</td></tr> 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 <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> de type @@ -508,8 +534,8 @@ serveur HTTP Apache</td></tr> <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 |