From d3eeee08a532a33497dcf837b0ee1609b10051a4 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sun, 9 Feb 2020 16:46:53 +0000 Subject: fr doc rebuild. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1873834 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_headers.html.fr.utf8 | 140 ++++++++++++++----------------- 1 file changed, 65 insertions(+), 75 deletions(-) (limited to 'docs/manual/mod/mod_headers.html.fr.utf8') diff --git a/docs/manual/mod/mod_headers.html.fr.utf8 b/docs/manual/mod/mod_headers.html.fr.utf8 index 6987432f7d..1e424bdded 100644 --- a/docs/manual/mod/mod_headers.html.fr.utf8 +++ b/docs/manual/mod/mod_headers.html.fr.utf8 @@ -249,73 +249,16 @@ version 2.4.10

L'argument optionnel condition permet de déterminer sur quelle table interne d'en-têtes de réponses cette directive va opérer : onsuccess (valeur par défaut, peut être omis) ou - always. A la différence de ceux de la première table, les - en-têtes de la seconde sont ajoutés à la réponse même en cas d'erreur et - sont conservés au fil des redirections internes (par exemple les - gestionnaires ErrorDocument). Notez aussi que la répétition - de cette directive avec les deux conditions peut être pertinente - dans certains scénarios, car always n'englobe pas - onsuccess en ce qui concerne les en-têtes existants :

- - - -

Comme il n'y a pas de liste unique "normalisée" d'en-têtes, la manière - dont httpd stocke en interne les en-têtes des réponses HTTP est à l'origine - de la fonctionnalité que constitue la différence entre - onsuccess et always. Si vous ne gardez pas à - l'esprit le concept ci-après lors de l'écriture de votre configuration, - certaines réponses HTTP pourront contenir des en-têtes dupliqués - (ce qui pourra dérouter les utilisateurs ou même parfois les clients HTTP). Supposons par - exemple que votre configuration comporte un mandataire PHP simple avec - mod_proxy_fcgi et que votre script PHP d'arrière-plan - ajoute l'en-tête X-Foo: bar à chaque réponse HTTP. Comme décrit - plus haut, mod_proxy_fcgi utilise la table - always pour stocker les en-têtes, et une configuration comme la - suivante n'aboutira pas au résultat attendu car l'en-tête sera dupliqué - avec les deux valeurs :

- -
# la valeur de X-Foo est définie dans la table d'en-têtes 'onsuccess'
-Header set X-Foo: baz
- - -

Plusieurs modèles de configuration permettent de contourner ce problème, - comme celui-ci :

- -
# 'onsuccess' peut être omis car il s'agit de la valeur par défaut
-Header onsuccess unset X-Foo
-Header always set X-Foo "baz"
- - -

Outre le paramètre condition 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.

- -

L'action que cette directive provoque est déterminée par le - premier argument (ou par le second argument si une - condition est spécifiée). Il peut prendre - une des valeurs suivantes :

+ always. La situation où vous devez spécifier + always dépend des différentes actions ci-dessous.

Avertissement

-

Vous devez lire la différence, décrite plus haut, entre les listes - d'en-têtes always et onsuccess avant de lire - la liste d'actions ci-dessous car cet important concept s'applique - encore ici. En fait, chaque action fonctionne telle qu'elle est décrite - mais seulement pour la liste d'en-têtes cible.

+

Etudiez avec attention la différence entre always et + onsuccess pour chaque action décrite ci-dessous car le + comportement induit n'est pas trivial et est souvent source de + confusion. Lorsqu'il est conseillé de répéter les conditions, vous + pouvez expérimenter chacune d'entre elles et utiliser celle qui vous + paraît la plus efficace pour correspondre à l'en-tête préexistant.

@@ -324,20 +267,35 @@ Header always set X-Foo "baz" 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 - set, append ou merge. + set, append ou merge. +

Choix de la condition : spécifiez la condition + always si vous souhaitez que l'en-tête soit aussi ajouté aux + réponses de type non-2xx (comme les redirections ou les erreurs).

+
append
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.
+ en-tête. +

Choix de la condition : si l'en-tête préexistant + auquel vous voulez ajouter une valeur a été ajouté par ce module, vous devez + spécifier la même condition que celle utilisée à l'origine. Dans le cas + contraire, vous devez déterminer expérimentalement si always + doit être spécifié car vous ne pouvez pas savoir de manière sure dans quelle + table interne la valeur existante est présente.

+
echo
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. en-tête peut être une expression rationnelle, et - valeur ne doit pas être présent.
+ valeur ne doit pas être présent. +

Choix de la condition : spécifiez la condition + always si vous souhaitez que l'en-tête soit aussi ajouté aux + réponses de type non-2xx (comme les redirections ou les erreurs).

+
edit
edit*
@@ -350,7 +308,13 @@ Header always set X-Foo "baz" arrières ou des spécificateurs de format. La forme edit n'effectuera une recherche/remplacement qu'une seule fois dans la valeur de l'en-tête, alors que la forme edit* en effectuera autant - que le nombre d'apparition de la chaîne à remplacer. + que le nombre d'apparition de la chaîne à remplacer. +

Choix de la condition : en fonction de l'origine de + l'en-tête à éditer, vous pourrez être amenés à répéter votre directive + edit/edit* avec les deux conditions always et + onsuccess. Autrement, vous pouvez déterminer expérimentalement + si une condition always est nécessaire.

+
merge
La valeur d'en-tête est ajoutée à tout en-tête de même nom, sauf @@ -361,17 +325,33 @@ Header always set X-Foo "baz" 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.
+ est considérée comme différente de la même valeur sans + guillemets. +

Choix de la condition : si l'en-tête préexistant + auquel vous voulez ajouter une valeur a été ajouté par ce module, vous devez + spécifier la même condition que celle utilisée à l'origine. Dans le cas + contraire, vous devez déterminer expérimentalement si always + est nécessaire.

+
set
L'en-tête est défini, remplaçant tout en-tête préexistant avec - le même nom. L'argument valeur peut être une chaîne de - formatage.
+ le même nom. L'argument valeur peut être une chaîne + formatée. +

Choix de la condition : si l'en-tête à définir a été + ajouté par ce module, vous devez spécifier la même condition que celle + utilisée à l'origine. Dans le cas contraire, vous devez déterminer + expérimentalement si always est nécessaire.

+
setifempty
L'en-tête est défini, mais seulement s'il n'existe aucun en-tête avec le même nom. +

Choix de la condition : si l'en-tête à définir a été + ajouté par ce module, vous devez spécifier la même condition que celle + utilisée à l'origine. Dans le cas contraire, vous devez déterminer + expérimentalement si always est nécessaire.

+
L'en-tête Content-Type est un cas particulier car il est possible que sa valeur ait été déterminée mais que l'en-tête ne soit pas présent dans la @@ -384,7 +364,12 @@ Header always set X-Foo "baz"
unset
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 - value ne doit pas apparaître.
+ value ne doit pas apparaître. +

Choix de la condition : répétez cette directive avec + les deux conditions always et onsuccess pour être + sur que l'en-tête soit bien supprimé, ou déterminez + expérimentalement si always est nécessaire.

+
note
La valeur de l'en-tête considéré est copiée dans une @@ -392,7 +377,12 @@ Header always set X-Foo "baz" valeur. 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.
- Disponible à partir de la version 2.4.7 du serveur HTTP Apache.
+ Disponible à partir de la version 2.4.7 du serveur HTTP Apache. +

Choix de la condition : si l'en-tête cible a été + ajouté par ce module, vous devez spécifier la même condition que celle + utilisée à l'origine. Dans le cas contraire, vous devez déterminer + expérimentalement si always est nécessaire.

+
-- cgit v1.2.3