1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>Messages d'erreur personnalisés - Serveur Apache HTTP</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Messages d'erreur personnalisés</h1>
21 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
22 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
23 <a href="./fr/custom-error.html" title="Français"> fr </a> |
24 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
25 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
26 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
29 <p>Le serveur HTTP Apache fournit des messages d'erreur génériques
30 pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
31 relativement austères, imprécis, et peuvent s'avérer intimidants
32 pour les visiteurs du site. Si vous le souhaitez, vous pouvez
33 afficher des messages d'erreur plus conviviaux, dans un langage
34 autre que l'anglais, ou même sous une forme plus en adéquation avec
35 le style de votre site.</p>
37 <p>Il est possible de définir des messages d'erreur personnalisés
38 pour chaque code de statut HTTP associé à une condition d'erreur -
39 c'est à dire tout code de statut 4xx ou 5xx.</p>
41 <p>De plus, il est possible de
42 personnaliser le message d'erreur en fonction d'un jeu de valeurs
43 fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté
44 Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
45 dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
46 pour gérer les conditions d'erreur.</p>
50 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
51 <li><img alt="" src="./images/down.gif" /> <a href="#variables">Variables disponibles</a></li>
52 <li><img alt="" src="./images/down.gif" /> <a href="#custom">Personnalisation des messages d'erreur</a></li>
53 <li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Messages d'erreur personnalisés
56 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
58 <h2><a name="configuration" id="configuration">Configuration</a></h2>
60 <p>Les messages d'erreur personnalisés sont configurés via la
61 directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>, qui
62 peut être utilisée dans un contexte global, serveur virtuel ou
63 répertoire. On peut utiliser cette directive dans les fichiers
64 .htaccess si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est
65 définie à FileInfo.</p>
67 <div class="example"><p><code>
68 ErrorDocument 500 "Désolé, notre script s'est crashé ; comme c'est
70 ErrorDocument 500 /cgi-bin/crash-recover<br />
71 ErrorDocument 500 http://erreur.example.com/erreur_serveur.html<br />
72 ErrorDocument 404 /erreurs/non_trouve.html <br />
73 ErrorDocument 401 /inscription/comment_s_inscrire.html
76 <p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
77 <div class="example"><p><code>
78 ErrorDocument <code_3_chiffres> <action>
80 <p>où action peut être :</p>
82 <li>Le texte à afficher. Entourez le texte de guillemets (").</li>
83 <li>Une URL de redirection local.</li>
84 <li>Une URL de redirection externe.</li>
87 <p>Dans le cas d'une redirection vers une URL locale, des variables
88 d'environnement supplémentaires sont définies de façon à ce que la
89 réponse puisse être personnalisée par la suite. Elles ne sont pas
90 envoyées aux URLs externes.</p>
92 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
94 <h2><a name="variables" id="variables">Variables disponibles</a></h2>
96 <p>La redirection vers une autre URL peut être utile, mais
97 seulement s'il est possible de transmettre certaines informations
98 qui pourront être utilisées pour expliquer ou journaliser
99 la condition d'erreur ou le problème plus clairement.</p>
101 <p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,
102 des variables d'environnement supplémentaires sont définies à
103 partir des en-têtes de la requête originale en préfixant le nom
104 d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au
105 message d'erreur le contexte de la requête originelle.</p>
107 <p>Par exemple, en plus des variables d'environnement habituelles,
108 vous pouvez recevoir ce qui suit :</p>
111 <div class="example"><p><code>
112 REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
113 REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
114 REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
115 REDIRECT_QUERY_STRING=<br />
116 REDIRECT_REMOTE_ADDR=121.345.78.123<br />
117 REDIRECT_REMOTE_HOST=client.example.com<br />
118 REDIRECT_SERVER_NAME=www.example.edu<br />
119 REDIRECT_SERVER_PORT=80<br />
120 REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
121 REDIRECT_URL=/cgi-bin/buggy.pl
124 <p>Les variables d'environnement <code>REDIRECT_</code> sont
125 créées à partir des variables d'environnement préexistantes à la
126 redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;
127 par exemple, <code>HTTP_USER_AGENT</code> devient
128 <code>REDIRECT_HTTP_USER_AGENT</code>.</p>
130 <p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
131 <code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,
132 les autres variables n'étant définies que si l'en-tête
133 correspondant existait avant la condition d'erreur.</p>
135 <p><strong>Aucune</strong> d'entre elles ne sera définie si votre
136 directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
137 spécifie une redirection <em>externe</em> (toute URL commençant
138 par un protocole du style <code>http:</code>, même si elle fait
139 référence au même hôte que le serveur).</p>
141 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
142 <div class="section">
143 <h2><a name="custom" id="custom">Personnalisation des messages d'erreur</a></h2>
146 <p>Si vous faites pointer votre directive
147 <code>ErrorDocument</code> vers certains gestionnaires
148 dynamiques comme les inclusions côté serveur, les scripts CGI ou
149 d'autres gestionnaires, vous pouvez utiliser les variables
150 d'environnement supplémentaires disponibles pour personnaliser
154 <p>Si la directive ErrorDocument spécifie une redirection locale
155 vers un script CGI, ce dernier doit ajouter un en-tête
156 "<code>Status:</code>" dans sa sortie afin de s'assurer du bon
157 acheminement jusqu'au client de la condition d'erreur qui a
158 provoqué cette redirection. Par exemple, un script Perl spécifié
159 par une directive ErrorDocument pourrait contenir ce qui suit
162 <div class="example"><p><code>
164 print "Content-type: text/html\n"; <br />
165 printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
169 <p>Si un script est dédié à la gestion d'une condition d'erreur
170 spécifique, telle que <code>404 Not Found</code>, il
171 peut utiliser le code et le texte de l'erreur spécifiques à la
174 <p>Notez que si la réponse contient un en-tête
175 <code>Location:</code> (afin d'initier une redirection côté
176 client), le script <em>doit</em> émettre un en-tête approprié
177 (comme <code>302 Found</code>). Dans le cas contraire,
178 l'en-tête <code>Location:</code> ne produira aucun effet.</p>
179 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
180 <div class="section">
181 <h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalisés
182 multilingues</a></h2>
184 <p>Vous trouverez dans la distribution du serveur HTTP Apache un
185 répertoire contenant des messages d'erreur personnalisés traduits en
186 16 langues différentes. Pour activer cette fonctionnalité, vous
187 pouvez aussi inclure un fichier de configuration qui se trouve dans
188 le répertoire de configuration <code>conf/extra</code>.</p>
190 <p>Dans le fichier de configuration de votre serveur, vous trouverez
191 un groupe de lignes du style :</p>
193 <div class="example"><p><code>
194 # Multi-language error messages<br />
195 #Include conf/extra/httpd-multilang-errordoc.conf
198 <p>Décommentez la ligne <code>Include</code> pour activer cette
199 fonctionnalité, et présenter des messages d'erreur dont le langage
200 sera négocié en fonction du langage préféré défini au niveau du
201 navigateur du client.</p>
203 <p>De plus, ces documents contiennent diverses variables
204 <code>REDIRECT_</code>, de façon à ce que l'utilisateur final
205 dispose d'informations supplémentaires à propos de ce qui a pu se
206 produire, et de ce qu'il est susceptible de faire maintenant.</p>
208 <p>Ces documents peuvent être personnalisés en fournissant autant
209 d'informations utiles que vous le souhaitez aux utilisateurs à
210 propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
212 <p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
213 <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> et <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>.</p>
216 <div class="bottomlang">
217 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
218 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
219 <a href="./fr/custom-error.html" title="Français"> fr </a> |
220 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
221 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
222 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
223 </div><div id="footer">
224 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
225 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>