Personnalisation des Messages d'Erreurs

Langues Disponibles: en | - es | - fr | - ja | - ko | - tr

- -

Il est possible à un administrateur Apache de configurer les réponses - d'Apache dans les cas où des erreurs ou problèmes se présentent.

- -

Des réponses paramétrables peuvent être définies pour être activées au - cas où le serveur détecterait une erreur ou un problème.

- -

Quand un script plante et génère une réponse "500 Server Error", sa - réponse peut être remplacée par un message plus convivial, ou par une - redirection vers une autre URL (locale, ou sur un autre serveur).

Fonctionnement
Configuration
Messages d'Erreurs Personnalisés et Redirections

Fonctionnement

- - -

Fonctionnement antérieur

- - -

NCSA httpd 1.3 renvoyait un message d'erreur insipide qui ne - présentait le plus souvent aucun sens ni à l'utilisateur, ni - dans les journaux d'enregistrement sur des symptômes causant - le plantage.

- - -

Fonctionnement des versions plus récentes

- - -

Le serveur peut être paramétré pour :

- -

Afficher un autre message que celui codé dans NCSA, ou bien
procéder à une redirection sur une URL locale, ou bien
procéder à une redirection vers un autre serveur.

- -

La redirection vers une autre URL peut être utile, mais seulement - si des informations peuvent être envoyées pour expliquer/enregistrer - l'erreur ou le problème plus clairement.

- -

Pour y parvenir, Apache définit de nouvelles variables - d'environnement CGI :

- -

- 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_QUERY_STRING= - REDIRECT_REMOTE_ADDR=121.345.78.123 - REDIRECT_REMOTE_HOST=ooh.ahhh.com - REDIRECT_SERVER_NAME=crash.bang.edu - REDIRECT_SERVER_PORT=80 - REDIRECT_SERVER_SOFTWARE=Apache/0.8.15 - REDIRECT_URL=/cgi-bin/buggy.pl -

- -

Notez que le préfixe REDIRECT_ est présent pour toutes - ces variables d'environnement.

- -

Au minimum, REDIRECT_URL et - REDIRECT_QUERY_STRING seront passées à la nouvelle - URL (en supposant qu'il s'agisse d'un script CGI ou d'un - include CGI). Les autres variables ne sont définies que si - elles existaient avant l'apparition du problème ou de l'erreur. - Aucune de ces variables ne sera - définie si votre directive ErrorDocument - entraîne une redirection vers un serveur externe ; - tout ce qui commence par http: est considéré comme - une redirection externe, y compris si cela pointe vers le - serveur local.

- -

Configuration

- - -

Il est possible d'utiliser la directive - ErrorDocument dans les fichiers - .htaccess si AllowOverride est - paramétrée pour le permettre.

- -

Voici quelques exemples :

- -

- ErrorDocument 500 /cgi-bin/crash-recover - ErrorDocument 500 "Sorry, our script crashed. Oh dear" - ErrorDocument 500 http://xxx/ - ErrorDocument 404 /Lame_excuses/not_found.html - ErrorDocument 401 /Subscription/how_to_subscribe.html -

- -

La syntaxe à utiliser est :

- -

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

- -

où l'action peut désigner :

- -

Un message à afficher. Le message doit être précédé par - des guillemets ("). Tout ce qui suit ces guillemets est affiché. - Notez que le préfixe (") n'est pas affiché.
Une URL vers un serveur externe, vers lequel la redirection - sera effectuée.
Une URL locale vers laquelle la redirection sera effectuée.

Messages d'Erreurs Personnalisés et Redirections

- - -

Le fonctionnement d'Apache vis-à-vis des redirections a été - modifié afin que les nouvelles variables d'environnement soient - disponibles pour un script ou un server-include.

- -

Fonctionnement antérieur

- - -

Les variables CGI standard étaient passées au script sur - lequel pointe la redirection. Aucune indication sur la - provenance de la redirection n'était fournie.

- - -

Fonctionnement pour les nouvelles versions

- - -

Une série de nouvelles variables d'environnement est - initialisée pour être passée au script sur lequel pointe - la redirection. Chacune de ces variables est munie du préfixe - REDIRECT_. Les variables d'environnement - REDIRECT_ sont créées à partir des variables - d'environnement "normales", telles qu'existant avant la - redirection, mais simplement renommées au moyen du préfixe - REDIRECT_ ; ainsi par exemple HTTP_USER_AGENT - devient REDIRECT_HTTP_USER_AGENT. En plus de ces - nouvelles variables, Apache définit REDIRECT_URL - et REDIRECT_status pour aider le script à - comprendre d'où il a été appelé. L'URL d'origine et l'URL - redirigée sont toutes deux ajoutées dans le journal "access".

- -

Si ErrorDocument précise une redirection - locale vers un script CGI, ce script devrait inclure un - champ "Status:" dans son en-tête de transmission - afin d'assurer que le client reçoive bien le code d'erreur et - puisse comprendre ce qui l'a causé. Par exemple, un script - Perl ErrorDocument pourrait inclure quelque chose comme :

- -

- ... - print "Content-type: text/html\n"; - printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; - ... -

- -

Un script dédié à la gestion d'une erreur donnée, - telle que 404 Not Found, peut bien sûr - utiliser le code spécifique d'erreur et le texte associé.

- -

Notez que le script doit envoyer l'en-tête - Status: appropriée (comme par exemple - 302 Found), si la réponse contient un en-tête - Location: (pour générer la redirection coté client). - Sans cet en-tête Status:, Location: n'aura - pas d'effet.

- -