Personnalisation des Messages d'Erreurs

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

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.