From 906c370c6282bab88553a917557b19ea523e92ab Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sat, 30 Jan 2016 16:43:13 +0000 Subject: [PATCH] XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1727726 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_cgi.xml.fr | 205 ++++++++------- docs/manual/mod/mod_deflate.xml.fr | 285 ++++++++++----------- docs/manual/mod/mod_setenvif.xml.fr | 205 +++++++-------- docs/manual/mod/mod_so.xml.fr | 143 +++++------ docs/manual/new_features_2_4.xml.fr | 370 ++++++++++++++-------------- 5 files changed, 626 insertions(+), 582 deletions(-) diff --git a/docs/manual/mod/mod_cgi.xml.fr b/docs/manual/mod/mod_cgi.xml.fr index e875fe280d..3f4dfaf3c8 100644 --- a/docs/manual/mod/mod_cgi.xml.fr +++ b/docs/manual/mod/mod_cgi.xml.fr @@ -1,7 +1,7 @@ - + - + @@ -25,112 +25,141 @@ mod_cgi -Exécution des scripts CGI +Exécution des scripts CGI Base mod_cgi.c cgi_module

Tout fichier pris en compte par le gestionnaire - cgi-script sera traité en tant que script CGI et - exécuté par le serveur, sa sortie étant renvoyée au client. Les - fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent - un nom contenant une extension définie par la directive cgi-script sera traité en tant que script CGI et + exécuté par le serveur, sa sortie étant renvoyée au client. Les + fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent + un nom contenant une extension définie par la directive AddHandler, soit parce qu'ils se - situent dans un répertoire défini par une directive ScriptAlias.

-

Comme introduction à l'utilisation des scripts CGI avec Apache, +

Comme introduction à l'utilisation des scripts CGI avec Apache, voir notre tutoriel Les contenus dynamiques avec CGI.

-

Le module mod_cgid doit être utilisé à la place +

Le module mod_cgid doit être utilisé à la place du module mod_cgi lorsqu'on utilise un module MPM - multi-threadé sous Unix. Vus de l'utilisateur, les deux modules + multi-threadé sous Unix. Vus de l'utilisateur, les deux modules sont pratiquement identiques.

-

À des fins de compatibilité ascendante, le gestionnaire - cgi-script sera également activé pour tout fichier possédant le type +

À des fins de compatibilité ascendante, le gestionnaire + cgi-script sera également activé pour tout fichier possédant le type MIME application/x-httpd-cgi. L'utilisation du type - MIME magic est obsolète.

+ MIME magic est obsolète.

 AcceptPathInfo Options ExecCGI ScriptAlias AddHandler -Exécuter des programmes CGI sous des -utilisateurs différents -La spécification +Exécuter des programmes CGI sous des +utilisateurs différents +La spécification CGI
Les variables d'environnement CGI -

Le serveur va définir les variables d'environnement CGI comme - décrit dans la Spécification CGI, de la - manière suivante :

+

Le serveur va définir les variables d'environnement CGI comme + décrit dans la Spécification CGI, de la + manière suivante :

PATH_INFO
Cette variable ne sera pas disponible si la directive AcceptPathInfo est - explicitement définie à off. Par défaut, si la - directive AcceptPathInfo n'est pas définie, + explicitement définie à off. Par défaut, si la + directive AcceptPathInfo n'est pas définie, mod_cgi acceptera des informations de chemin (en - ajoutant /infos/chemin après le nom du script dans l'URI), alors + ajoutant /infos/chemin après le nom du script dans l'URI), alors que le serveur de base retournera une erreur 404 NOT FOUND pour - les requêtes contenant des informations de chemin supplémentaires. - Ne pas définir la directive AcceptPathInfo - a le même effet sur les requêtes avec mod_cgi que - de la définir à On.
+ les requêtes contenant des informations de chemin supplémentaires. + Ne pas définir la directive AcceptPathInfo + a le même effet sur les requêtes avec mod_cgi que + de la définir à On.
REMOTE_HOST
-
Cette variable ne sera définie que si la directive HostnameLookups est définie à - on (elle est à off par défaut), et si - une recherche DNS inverse sur l'adresse IP de l'hôte client - aboutit effectivement à un nom d'hôte.
+
Cette variable ne sera définie que si la directive HostnameLookups est définie à + on (elle est à off par défaut), et si + une recherche DNS inverse sur l'adresse IP de l'hôte client + aboutit effectivement à un nom d'hôte.
REMOTE_IDENT
-
Cette variable ne sera définie que si la directive Cette variable ne sera définie que si la directive IdentityCheck - est définie à on, et si l'hôte client supporte le + est définie à on, et si l'hôte client supporte le protocole ident. Notez que l'on ne peut accorder une confiance - aveugle au contenu de cette variable car il peut être aisément - falsifié, et si un mandataire s'intercale entre le client et le + aveugle au contenu de cette variable car il peut être aisément + falsifié, et si un mandataire s'intercale entre le client et le serveur, il est totalement inutilisable.
REMOTE_USER
-
Cette variable ne sera définie que si le script CGI fait +
Cette variable ne sera définie que si le script CGI fait l'objet d'une authentification.
+
+

Ce module utilise aussi les fonctions de base ap_add_common_vars + et ap_add_cgi_vars + pour ajouter des variables d'environnement comme :

+
+
DOCUMENT_ROOT
+ +
Prend la valeur définie par la directive DocumentRoot.
+ +
SERVER_NAME
+ +
Le nom de domaine pleinement qualifié pour la requête considérée
+ +
SERVER_ADDR
+ +
L'adresse IP du serveur virtuel qui traite la requête
+ +
SERVER_ADMIN
+ +
Prend la valeur définie par la directive ServerAdmin.
+
+

Pour une liste exhaustive de ces variables, vous pouvez écrire un script + CGI basique qui extrait toutes les variables d'environnement passées par + Apache selon un format adapté. +

-
Débogage des scripts CGI -

Le débogage des scripts CGI était difficile par le passé, - principalement parce qu'il n'était pas possible d'étudier la sortie - (sortie standard et erreurs) des scripts dont l'exécution échouait. - Ces directives permettent une journalisation plus détaillée des +

Débogage des scripts CGI +

Le débogage des scripts CGI était difficile par le passé, + principalement parce qu'il n'était pas possible d'étudier la sortie + (sortie standard et erreurs) des scripts dont l'exécution échouait. + Ces directives permettent une journalisation plus détaillée des erreurs.

Format du fichier journal CGI -

Lorsqu'il est configuré, le journal des erreurs CGI enregistre - la sortie de tout programme CGI dont l'exécution ne s'effectue pas - correctement. Un script CGI dont l'exécution échoue provoque la - journalisation d'une grande quantité d'informations. Les deux - premières lignes possèdent toujours le format suivant :

+

Lorsqu'il est configuré, le journal des erreurs CGI enregistre + la sortie de tout programme CGI dont l'exécution ne s'effectue pas + correctement. Un script CGI dont l'exécution échoue provoque la + journalisation d'une grande quantité d'informations. Les deux + premières lignes possèdent toujours le format suivant :

- %% [date] requête
- %% état HTTP nom du script CGI + %% [date] requête
+ %% état HTTP nom du script CGI -

Si le script CGI n'a pas pu démarrer, le fichier journal - contiendra les deux lignes supplémentaires suivantes :

+

Si le script CGI n'a pas pu démarrer, le fichier journal + contiendra les deux lignes supplémentaires suivantes :

%%erreur
@@ -138,16 +167,16 @@ CGI

Par contre, si l'erreur provient du renvoi par le script - d'informations incorrectes dans les en-têtes (dû souvent à une - bogue du script), les informations suivantes sont journalisées + d'informations incorrectes dans les en-têtes (dû souvent à une + bogue du script), les informations suivantes sont journalisées :

- %requête
- Tous les en-têtes de requête HTTP reçus
- Les entités POST ou PUT (s'il en existe)
- %réponse
- Tous les en-têtes générés par le script CGI
+ %requête
+ Tous les en-têtes de requête HTTP reçus
+ Les entités POST ou PUT (s'il en existe)
+ %réponse
+ Tous les en-têtes générés par le script CGI
%stdout
la sortie standard CGI
%stderr
@@ -155,7 +184,7 @@ CGI

(Les parties %stdout et %stderr seront absentes si le script - n'a rien envoyé sur la sortie standard ou la sortie + n'a rien envoyé sur la sortie standard ou la sortie d'erreurs).

@@ -171,13 +200,13 @@ CGI -

La directive ScriptLog définit +

La directive ScriptLog définit le chemin du fichier journal des erreurs du script CGI. Si cette - directive n'est pas définie, aucune journalisation des erreurs n'est - effectuée. Si elle est définie, toute erreur CGI sera enregistrée + directive n'est pas définie, aucune journalisation des erreurs n'est + effectuée. Si elle est définie, toute erreur CGI sera enregistrée dans le fichier dont le nom est fourni en argument. S'il s'agit d'un - chemin de fichier relatif, il est considéré par rapport au - répertoire défini par la directive ServerRoot.

@@ -188,23 +217,23 @@ CGI

Ce journal sera ouvert par l'utilisateur sous lequel les - processus enfants s'exécutent, c'est à dire l'utilisateur spécifié + processus enfants s'exécutent, c'est à dire l'utilisateur spécifié par la directive du serveur User. Ceci implique que soit le - répertoire dans lequel se trouve le journal doit être accessible en - écriture pour cet utilisateur, soit le fichier doit être créé - manuellement et accessible en écriture pour cet utilisateur. Si vous - placez le journal du script dans votre répertoire principal des + répertoire dans lequel se trouve le journal doit être accessible en + écriture pour cet utilisateur, soit le fichier doit être créé + manuellement et accessible en écriture pour cet utilisateur. Si vous + placez le journal du script dans votre répertoire principal des journaux, ne modifiez PAS les permissions de ce - dernier afin de le le rendre accessible en écriture par - l'utilisateur sous lequel les processus enfants s'exécutent.

+ dernier afin de le le rendre accessible en écriture par + l'utilisateur sous lequel les processus enfants s'exécutent.

Notez que l'on ne doit activer la journalisation des scripts - qu'à des fins de débogage lors de l'écriture de scripts CGI, et non - de manière permanente sur un serveur en production. Elle n'est pas - optimisée en ce qui concerne la vitesse et l'efficacité, et peut - présenter des problèmes de sécurité si on l'utilise dans un cadre - autre que celui pour lequel elle a été conçue.

+ qu'à des fins de débogage lors de l'écriture de scripts CGI, et non + de manière permanente sur un serveur en production. Elle n'est pas + optimisée en ce qui concerne la vitesse et l'efficacité, et peut + présenter des problèmes de sécurité si on l'utilise dans un cadre + autre que celui pour lequel elle a été conçue.

 @@ -221,21 +250,21 @@ CGI

La directive ScriptLogLength - définit la taille maximale du fichier journal des scripts CGI. Comme - le fichier journal accumule une grande quantité d'informations par - erreur CGI (tous les en-têtes de la requête, toutes les sorties du + définit la taille maximale du fichier journal des scripts CGI. Comme + le fichier journal accumule une grande quantité d'informations par + erreur CGI (tous les en-têtes de la requête, toutes les sorties du script), il peut vite atteindre une grande taille. En limitant la - taille du fichier, cette directive permet d'éviter les problèmes que + taille du fichier, cette directive permet d'éviter les problèmes que causerait sa croissance sans limites. Lorsque le fichier a atteint cette taille maximale, plus aucune information n'y est - enregistrée.

+ enregistrée.

 ScriptLogBuffer -Taille maximale des requêtes PUT ou POST qui seront -enregistrées dans le journal du script +Taille maximale des requêtes PUT ou POST qui seront +enregistrées dans le journal du script ScriptLogBuffer octets ScriptLogBuffer 1024 server config @@ -245,11 +274,11 @@ enregistrées dans le journal du script

Cette directive limite la taille du corps de toute - entité PUT ou POST qui sera enregistrée dans le journal, afin - de prévenir une croissance trop importante et trop rapide du fichier - journal due à la réception de corps de requête de grandes tailles. + entité PUT ou POST qui sera enregistrée dans le journal, afin + de prévenir une croissance trop importante et trop rapide du fichier + journal due à la réception de corps de requête de grandes tailles. Cette directive modifie cette taille maximale, dont la - valeur par défaut est de 1024 octets.

+ valeur par défaut est de 1024 octets.

 diff --git a/docs/manual/mod/mod_deflate.xml.fr b/docs/manual/mod/mod_deflate.xml.fr index 66b809b191..bd099cc89f 100644 --- a/docs/manual/mod/mod_deflate.xml.fr +++ b/docs/manual/mod/mod_deflate.xml.fr @@ -1,7 +1,7 @@ - + - + @@ -32,30 +32,30 @@ client deflate_module -

Le module mod_deflate implémente le filtre de +

Le module mod_deflate implémente le filtre de sortie DEFLATE qui permet de comprimer la sortie de - votre serveur avant de l'envoyer au client sur le réseau.

+ votre serveur avant de l'envoyer au client sur le réseau.

 Les filtres -
Codages supportés -

Le seul codage supporté est gzip afin d'assurer une complète - compatibilité avec les anciens navigateurs. Le codage deflate - n'est donc pas supporté ; voir à ce sujet la Codages supportés +

Le seul codage supporté est gzip afin d'assurer une complète + compatibilité avec les anciens navigateurs. Le codage deflate + n'est donc pas supporté ; voir à ce sujet la documentation de zlib - pour une explication détaillée. + pour une explication détaillée.