From: Lucien Gentis Date: Sun, 9 Feb 2020 16:44:42 +0000 (+0000) Subject: fr doc XML files updates. X-Git-Tag: 2.5.0-alpha2-ci-test-only~1668 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=be50b48b92546da5c42b1e1504cd071229597e7d;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML files updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1873833 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_deflate.xml.fr b/docs/manual/mod/mod_deflate.xml.fr index 2e99abad788..2070f06e6de 100644 --- a/docs/manual/mod/mod_deflate.xml.fr +++ b/docs/manual/mod/mod_deflate.xml.fr @@ -1,7 +1,7 @@ - + @@ -81,7 +81,7 @@ client SetOutputFilter DEFLATE -SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip +SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip

Si vous voulez limiter la compression à certains types MIME @@ -377,42 +377,6 @@ sortie - -DeflateAlterETag -Comment l'en-tête sortant ETag doit être modifié au cours -de la compression -DeflateAlterETag AddSuffix|NoChange|Remove -DeflateAlterETag AddSuffix -server configvirtual host - - - -

La directive DeflateAlterETag permet de - spécifier comment l'en-tête ETag doit être modifié lorsqu'une - réponse est compressée.

-
-
AddSuffix
-

Ajoute la méthode de compression à la fin de l'en-tête, ce - qui a pour effet d'attribuer un en-tête ETag unique aux - représentations compressées et non compressées. C'est l'option par - défaut depuis la version 2.4.0, mais empêche de servir des - codes d'état "HTTP Not Modified" (304) en réponse aux requêtes pour un - contenu compressé.

-
NoChange
-

Ne modifie pas l'en-tête ETag dans une réponse compressée. - C'était l'option par - défaut avant la version 2.4.0, mais cela ne respectait pas la - préconisation HTTP/1.1 selon laquelle chaque représentation de la - même ressource doit posséder un en-tête ETag unique.

-
Remove
-

Supprime l'en-tête ETag dans les réponses compressées, ce qui - a pour effet de rendre impossibles certaines requêtes - conditionnelles, mais permet d'éviter les inconvénients des options - précédentes.

-
- - - DeflateInflateLimitRequestBody Taille maximale des corps de requête décompressés @@ -476,5 +440,41 @@ Apache + +DeflateAlterETag +Comment l'en-tête sortant ETag doit être modifié au cours +de la compression +DeflateAlterETag AddSuffix|NoChange|Remove +DeflateAlterETag AddSuffix +server configvirtual host + + + +

La directive DeflateAlterETag permet de + spécifier comment l'en-tête ETag doit être modifié lorsqu'une + réponse est compressée.

+
+
AddSuffix
+

Ajoute la méthode de compression à la fin de l'en-tête, ce + qui a pour effet d'attribuer un en-tête ETag unique aux + représentations compressées et non compressées. C'est l'option par + défaut depuis la version 2.4.0, mais empêche de servir des + codes d'état "HTTP Not Modified" (304) en réponse aux requêtes pour un + contenu compressé.

+
NoChange
+

Ne modifie pas l'en-tête ETag dans une réponse compressée. + C'était l'option par + défaut avant la version 2.4.0, mais cela ne respectait pas la + préconisation HTTP/1.1 selon laquelle chaque représentation de la + même ressource doit posséder un en-tête ETag unique.

+
Remove
+

Supprime l'en-tête ETag dans les réponses compressées, ce qui + a pour effet de rendre impossibles certaines requêtes + conditionnelles, mais permet d'éviter les inconvénients des options + précédentes.

+
+ + + diff --git a/docs/manual/mod/mod_headers.xml.fr b/docs/manual/mod/mod_headers.xml.fr index deaa4c0837e..eccf1f5340c 100644 --- a/docs/manual/mod/mod_headers.xml.fr +++ b/docs/manual/mod/mod_headers.xml.fr @@ -1,7 +1,7 @@ - + @@ -367,75 +367,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.
@@ -444,20 +385,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*
@@ -470,7 +426,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 @@ -481,17 +443,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 @@ -505,7 +483,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 @@ -513,7 +496,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.

+
diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr index e5c48698b93..226655ee871 100644 --- a/docs/manual/mod/mod_rewrite.xml.fr +++ b/docs/manual/mod/mod_rewrite.xml.fr @@ -1,7 +1,7 @@ - + @@ -1481,7 +1481,7 @@ substitution ! cookie|CO=NAME:VAL Définit un cookie au niveau du navigateur client. La syntaxe complète est : - CO=NAME:VAL:domain[:lifetime[:path[:secure[:httponly]]]] details ... + CO=NAME:VAL:domain[:lifetime[:path[:secure[:httponly[samesite]]]]] details ... détails ... diff --git a/docs/manual/mod/mod_systemd.xml.fr b/docs/manual/mod/mod_systemd.xml.fr index 6391def3b93..3d737c2ab8a 100644 --- a/docs/manual/mod/mod_systemd.xml.fr +++ b/docs/manual/mod/mod_systemd.xml.fr @@ -1,7 +1,7 @@ - + - + + @@ -152,13 +152,13 @@ chaînées qui suivent, seront sautées.

Le drapeau [CO], ou [cookie], vous permet de définir un cookie lorsqu'une règle RewriteRule s'applique. Il possède trois arguments obligatoires et -quatre arguments optionnels.

+cinq arguments optionnels.

La syntaxe complète de ce drapeau, avec tous ses attributs, est la suivante :

-[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly] +[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly:samesite]

Si un caractère littéral ':' doit être insérer dans un des champs du @@ -167,7 +167,7 @@ alternative, le contenu du champ "Name" doit être précédé du caractère ';', et les sépateurs de champs deviendront des ';'.

-[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly] +[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly;samesite]

Vous devez déclarer un nom, une valeur et un domaine pour que @@ -210,6 +210,12 @@ que dans le cadre d'une connexion sécurisée (https). HttpOnly activé, ce qui signifie qu'il sera inaccessible au code JavaScript pour les navigateurs qui supportent cette fonctionnalité. + +

samesite
+
S'il est différent de 0, l'attribut SameSite est défini à la +valeur spécifiée. Les valeurs typiques sont None, Lax +et Strict. Disponible à partir de la version 2.5.1 du serveur HTTP +Apache.

Voici un exemple :