From 3746684f54e8897ab588b00869febc8e1cd3fff1 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sun, 14 Mar 2010 17:30:01 +0000 Subject: [PATCH] Updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@922903 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/bind.xml.fr | 23 +-- docs/manual/caching.xml.fr | 78 ++++++---- docs/manual/custom-error.xml.fr | 259 ++++++++++++++++---------------- docs/manual/server-wide.xml.fr | 10 +- docs/manual/stopping.xml.fr | 17 ++- docs/manual/suexec.xml.fr | 50 +++--- docs/manual/upgrading.xml.fr | 8 +- docs/manual/urlmapping.xml.fr | 23 +-- 8 files changed, 248 insertions(+), 220 deletions(-) diff --git a/docs/manual/bind.xml.fr b/docs/manual/bind.xml.fr index db10dc8404..0dfa6691c9 100644 --- a/docs/manual/bind.xml.fr +++ b/docs/manual/bind.xml.fr @@ -3,7 +3,7 @@ - + - + + @@ -27,152 +27,123 @@ Messages d'erreur personnalisés -

Une fonctionnalité additionnelle permet aux webmasters de - configurer la réponse d'Apache à certaines erreurs ou problèmes.

- -

Il est possible de définir des réponses personnalisables comme - devant être activées lorsque le serveur détecte une erreur ou un - problème.

- -

Si un script se crashe et provoque l'envoi d'une réponse "500 - Server Error", cette dernière peut être remplacée soit par un texte - plus convivial, soit par une redirection vers une autre URL (locale - ou externe).

+

Le serveur HTTP Apache fournit des messages d'erreur génériques + pour les codes de statut 4xx ou 5xx ; ces messages sont cependant + relativement austères, imprécis, et peuvent s'avérer intimidants + pour les visiteurs du site. Si vous le souhaitez, vous pouvez + afficher des messages d'erreur plus conviviaux, dans un langage + autre que l'anglais, ou même sous une forme plus en adéquation avec + le style de votre site.

+ +

Il est possible de définir des messages d'erreur personnalisés + pour chaque code de statut HTTP associé à une condition d'erreur - + c'est à dire tout code de statut 4xx ou 5xx.

+ +

De plus, il est possible de + personnaliser le message d'erreur en fonction d'un jeu de valeurs + fourni, en utilisant les Inclusions Côté + Serveur (SSI). Un programme CGI ou un autre gestionnaire + dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables + pour gérer les conditions d'erreur.

+ + -
- Comportement - -
- Ancien comportement +
Configuration -

httpd 1.3 de NCSA renvoyait d'antiques et obscurs messages - d'erreur ou de problème qui la plupart du temps n'avaient aucune - signification pour l'utilisateur, et ne permettaient pas de - journaliser les symptomes qui les avaient causés.

-
+

Les messages d'erreur personnalisés sont configurés via la + directive ErrorDocument, qui + peut être utilisée dans un contexte global, serveur virtuel ou + répertoire. On peut utiliser cette directive dans les fichiers + .htaccess si AllowOverride est + définie à FileInfo.

-
- Nouveau comportement - -

Il est possible de demander au serveur :

+ + ErrorDocument 500 "Désolé, notre script s'est crashé ; comme c'est + dommage !"
+ ErrorDocument 500 /cgi-bin/crash-recover
+ ErrorDocument 500 http://erreur.example.com/erreur_serveur.html
+ ErrorDocument 404 /erreurs/non_trouve.html
+ ErrorDocument 401 /inscription/comment_s_inscrire.html + + +

La syntaxe de la directive ErrorDocument est :

+ + ErrorDocument <code_3_chiffres> <action> + +

où action peut être :

+
    +
  1. Le texte à afficher. Entourez le texte de guillemets (").
    2. +
  2. Une URL de redirection local.
    3. +
  3. Une URL de redirection externe.
    4. +
-
    -
  1. d'afficher un autre texte à la place du message NCSA codé en - dur, ou
    2. +

    Dans le cas d'une redirection vers une URL locale, des variables + d'environnement supplémentaires sont définies de façon à ce que la + réponse puisse être personnalisée par la suite. Elles ne sont pas + envoyées aux URLs externes.

    -
  2. rediriger vers une URL locale, ou
    3. +
-
  • rediriger vers une URL externe.
    • - +
    Variables disponibles

    La redirection vers une autre URL peut être utile, mais seulement s'il est possible de transmettre certaines informations - qui pourront être utilisées pour expliquer et/ou journaliser - l'erreur ou le problème plus clairement.

    + qui pourront être utilisées pour expliquer ou journaliser + la condition d'erreur ou le problème plus clairement.

    -

    Pour y parvenir, Apache va définir de nouvelles variables - d'environnement de style CGI :

    +

    Pour y parvenir, lorsque la redirection d'erreur est envoyée, + des variables d'environnement supplémentaires sont définies à + partir des en-têtes de la requête originale en préfixant le nom + d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au + message d'erreur le contexte de la requête originelle.

    + +

    Par exemple, en plus des variables d'environnement habituelles, + vous pouvez recevoir ce qui suit :

    + - REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, - image/jpeg
    - REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05 - 9000/712)
    - REDIRECT_PATH=.:/bin:/usr/local/bin:/etc
    + REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png
    + REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8
    + REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin
    REDIRECT_QUERY_STRING=
    REDIRECT_REMOTE_ADDR=121.345.78.123
    - REDIRECT_REMOTE_HOST=ooh.ahhh.com
    - REDIRECT_SERVER_NAME=crash.bang.edu
    + REDIRECT_REMOTE_HOST=client.example.com
    + REDIRECT_SERVER_NAME=www.example.edu
    REDIRECT_SERVER_PORT=80
    - REDIRECT_SERVER_SOFTWARE=Apache/0.8.15
    + REDIRECT_SERVER_SOFTWARE=Apache/2.2.15
    REDIRECT_URL=/cgi-bin/buggy.pl     -

    Notez le préfixe REDIRECT_.

    +

    Les variables d'environnement REDIRECT_ sont + créées à partir des variables d'environnement préexistantes à la + redirection qui sont préfixées par la chaîne REDIRECT_ ; + par exemple, HTTP_USER_AGENT devient + REDIRECT_HTTP_USER_AGENT.

    + +

    REDIRECT_URL, REDIRECT_STATUS, et + REDIRECT_QUERY_STRING sont systématiquement définies, + les autres variables n'étant définies que si l'en-tête + correspondant existait avant la condition d'erreur.

    -

    Au minimum REDIRECT_URL et - REDIRECT_QUERY_STRING seront transmises à la nouvelle - URL (en supposant qu'il s'agit d'une inclusion ou d'un script - cgi). Les autres variables ne seront présentes que si elles - existaient avant que l'erreur ou le problème ne survienne. - Aucune d'entre elles ne sera définie si votre +

    Aucune d'entre elles ne sera définie si votre directive ErrorDocument spécifie une redirection externe (toute URL commençant par un protocole du style http:, même si elle fait référence au même hôte que le serveur).

    -
    +
    -
    - Configuration - -

    L'utilisation de la directive ErrorDocument est activée pour les - fichiers .htaccess si la directive AllowOverride est positionnée dans cette - optique.

    - -

    Voici quelques exemples...

    - - - ErrorDocument 500 /cgi-bin/crash-recover
    - ErrorDocument 500 "Toutes nos excuses, notre script s'est crashé." -
    - ErrorDocument 500 http://xxx/
    - ErrorDocument 404 /Lame_excuses/not_found.html
    - ErrorDocument 401 /Subscription/how_to_subscribe.html -     - -

    La syntaxe est la suivante :

    - - - ErrorDocument <code à 3 chiffres> <action> - - -

    où action peut être :

    - -
      -
    1. Un texte à afficher. Entourez-le de guillemets (").
      2. - -
    2. Une URL externe vers laquelle on sera redirigé.
      3. - -
    3. Une URL locale vers laquelle on sera redirigé.
      4. -
    -
    +
    Personnalisation des messages d'erreur -
    - Messages d'erreur et de redirection personnalisés - -

    Lors d'une redirection d'URL, Apache a modifié son comportement - et les scripts ou inclusions côté serveur disposent maintenant de - variables d'environnement supplémentaires.

    - -
    - Ancien comportement - -

    Un script vers lequel une requête avait été redirigée - avait accès aux variables CGI standards, sans indication sur - l'origine de la redirection.

    -
    - -
    - Nouveau comportement - -

    Un nouveau jeu de variables d'environnement va être initialisé - à des fins d'utilisation par un script vers lequel une requête - aura été redirigée. Chaque nouvelle variable sera préfixée par - REDIRECT_. Les variables d'environnement - REDIRECT_ sont créées à partir des variables - d'environnement CGI existant avant la redirection, et renommées en - leur ajoutant le préfixe REDIRECT_ ; par exemple, - HTTP_USER_AGENT devient - REDIRECT_HTTP_USER_AGENT. En plus de ces nouvelles - variables, Apache va définir REDIRECT_URL et - REDIRECT_STATUS pour aider le script à remonter à - l'origine de la redirection. L'URL originale et l'URL de - redirection peuvent être enregistrées dans le journal des - accès.

    + +

    Si vous faites pointer votre directive + ErrorDocument vers certains gestionnaires + dynamiques comme les inclusions côté serveur, les scripts CGI ou + d'autres gestionnaires, vous pouvez utiliser les variables + d'environnement supplémentaires disponibles pour personnaliser + le message.

    +

    Si la directive ErrorDocument spécifie une redirection locale vers un script CGI, ce dernier doit ajouter un en-tête @@ -195,11 +166,47 @@ place.

    Notez que si la réponse contient un en-tête - Location:, le script doit émettre un en-tête - Status: approprié (tel que - 302 Found) afin de provoquer une redirection au - niveau du client. Dans le cas contraire, l'en-tête - Location: risque de n'avoir aucun effet.

    -
    + Location: (afin d'initier une redirection côté + client), le script doit émettre un en-tête approprié + (comme 302 Found). Dans le cas contraire, + l'en-tête Location: ne produira aucun effet.

    + +
    Messages d'erreur personnalisés + multilingues + +

    Vous trouverez dans la distribution du serveur HTTP Apache un + répertoire contenant des messages d'erreur personnalisés traduits en + 16 langues différentes. Pour activer cette fonctionnalité, vous + pouvez aussi inclure un fichier de configuration qui se trouve dans + le répertoire de configuration conf/extra.

    + +

    Dans le fichier de configuration de votre serveur, vous trouverez + un groupe de lignes du style :

    + + + # Multi-language error messages
    + #Include conf/extra/httpd-multilang-errordoc.conf +     + +

    Décommentez la ligne Include pour activer cette + fonctionnalité, et présenter des messages d'erreur dont le langage + sera négocié en fonction du langage préféré défini au niveau du + navigateur du client.

    + +

    De plus, ces documents contiennent diverses variables + REDIRECT_, de façon à ce que l'utilisateur final + dispose d'informations supplémentaires à propos de ce qui a pu se + produire, et de ce qu'il est susceptible de faire maintenant.

    + +

    Ces documents peuvent être personnalisés en fournissant autant + d'informations utiles que vous le souhaitez aux utilisateurs à + propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.

    + +

    Pour pouvoir utiliser cette fonctionnalité, vous devez activer + mod_include et mod_negotiation.

    + +
    + + diff --git a/docs/manual/server-wide.xml.fr b/docs/manual/server-wide.xml.fr index 96cff3d406..3e63206d51 100644 --- a/docs/manual/server-wide.xml.fr +++ b/docs/manual/server-wide.xml.fr @@ -3,7 +3,7 @@ - + - + - + - + +
    diff --git a/docs/manual/urlmapping.xml.fr b/docs/manual/urlmapping.xml.fr index 3b8522a22c..d6184345e4 100644 --- a/docs/manual/urlmapping.xml.fr +++ b/docs/manual/urlmapping.xml.fr @@ -3,7 +3,7 @@ - +