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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Messages d'erreur personnalisés - Serveur Apache HTTP Version 2.5</title>
11 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
14 <script src="./style/scripts/prettify.min.js" type="text/javascript">
17 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
18 <body id="manual-page"><div id="page-header">
19 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
20 <p class="apache">Serveur Apache HTTP Version 2.5</p>
21 <img alt="" src="./images/feather.png" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
24 <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.5</a></div><div id="page-content"><div id="preamble"><h1>Messages d'erreur personnalisés</h1>
26 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
27 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
28 <a href="./fr/custom-error.html" title="Français"> fr </a> |
29 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
30 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
31 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
33 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
34 anglaise pour les changements récents.</div>
36 <p>Le serveur HTTP Apache fournit des messages d'erreur génériques
37 pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
38 relativement austères, imprécis, et peuvent s'avérer intimidants
39 pour les visiteurs du site. Si vous le souhaitez, vous pouvez
40 afficher des messages d'erreur plus conviviaux, dans un langage
41 autre que l'anglais, ou même sous une forme plus en adéquation avec
42 le style de votre site.</p>
44 <p>Il est possible de définir des messages d'erreur personnalisés
45 pour chaque code de statut HTTP associé à une condition d'erreur -
46 c'est à dire tout code de statut 4xx ou 5xx.</p>
48 <p>De plus, il est possible de
49 personnaliser le message d'erreur en fonction d'un jeu de valeurs
50 fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté
51 Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
52 dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
53 pour gérer les conditions d'erreur.</p>
57 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
58 <li><img alt="" src="./images/down.gif" /> <a href="#variables">Variables disponibles</a></li>
59 <li><img alt="" src="./images/down.gif" /> <a href="#custom">Personnalisation des messages d'erreur</a></li>
60 <li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Messages d'erreur personnalisés
62 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
63 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
65 <h2><a name="configuration" id="configuration">Configuration</a></h2>
67 <p>Les messages d'erreur personnalisés sont configurés via la
68 directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>, qui
69 peut être utilisée dans un contexte global, serveur virtuel ou
70 répertoire. On peut utiliser cette directive dans les fichiers
71 .htaccess si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est
72 définie à FileInfo.</p>
74 <pre class="prettyprint lang-config">ErrorDocument 500 "Désolé, notre script s'est
75 crashé ; comme c'est dommage !"
76 ErrorDocument 500 /cgi-bin/crash-recover
77 ErrorDocument 500 http://error.example.com/server_error.html
78 ErrorDocument 404 /errors/not_found.html
79 ErrorDocument 401 /subscription/how_to_subscribe.html</pre>
82 <p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
83 <pre class="prettyprint lang-config">ErrorDocument <code_3_chiffres> <action></pre>
85 <p>où action peut être traitée comme :</p>
87 <li>Une URL de redirection local (si l'action commence par un "/").</li>
88 <li>Une URL de redirection externe (si action est une URL valide).</li>
89 <li>Le texte à afficher (si l'action ne répond à aucune des
90 deux conditions précédentes). Entourez le texte de guillemets (")
91 s'il contient plusieurs mots.</li>
94 <p>Dans le cas d'une redirection vers une URL locale, des variables
95 d'environnement supplémentaires sont définies de façon à ce que la
96 réponse puisse être personnalisée par la suite. Elles ne sont pas
97 envoyées aux URLs externes.</p>
99 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
100 <div class="section">
101 <h2><a name="variables" id="variables">Variables disponibles</a></h2>
103 <p>La redirection vers une autre URL peut être utile, mais
104 seulement s'il est possible de transmettre certaines informations
105 qui pourront être utilisées pour expliquer ou journaliser
106 la condition d'erreur ou le problème plus clairement.</p>
108 <p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,
109 des variables d'environnement supplémentaires sont définies à
110 partir des en-têtes de la requête originale en préfixant le nom
111 d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au
112 message d'erreur le contexte de la requête originelle.</p>
114 <p>Par exemple, en plus des variables d'environnement habituelles,
115 vous pouvez recevoir ce qui suit :</p>
118 <div class="example"><p><code>
119 REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
120 REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
121 REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
122 REDIRECT_QUERY_STRING=<br />
123 REDIRECT_REMOTE_ADDR=121.345.78.123<br />
124 REDIRECT_REMOTE_HOST=client.example.com<br />
125 REDIRECT_SERVER_NAME=www.example.edu<br />
126 REDIRECT_SERVER_PORT=80<br />
127 REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
128 REDIRECT_URL=/cgi-bin/buggy.pl
131 <p>Les variables d'environnement <code>REDIRECT_</code> sont
132 créées à partir des variables d'environnement préexistantes à la
133 redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;
134 par exemple, <code>HTTP_USER_AGENT</code> devient
135 <code>REDIRECT_HTTP_USER_AGENT</code>.</p>
137 <p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
138 <code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,
139 les autres variables n'étant définies que si l'en-tête
140 correspondant existait avant la condition d'erreur.</p>
142 <p><strong>Aucune</strong> d'entre elles ne sera définie si votre
143 directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
144 spécifie une redirection <em>externe</em> (toute URL commençant
145 par un protocole du style <code>http:</code>, même si elle fait
146 référence au même hôte que le serveur).</p>
148 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
149 <div class="section">
150 <h2><a name="custom" id="custom">Personnalisation des messages d'erreur</a></h2>
153 <p>Si vous faites pointer votre directive
154 <code>ErrorDocument</code> vers certains gestionnaires
155 dynamiques comme les inclusions côté serveur, les scripts CGI ou
156 d'autres gestionnaires, vous pouvez utiliser les variables
157 d'environnement supplémentaires disponibles pour personnaliser
161 <p>Si la directive ErrorDname-basedocument spécifie une redirection locale
162 vers un script CGI, ce dernier doit ajouter un en-tête
163 "<code>Status:</code>" dans sa sortie afin de s'assurer du bon
164 acheminement jusqu'au client de la condition d'erreur qui a
165 provoqué cette redirection. Par exemple, un script Perl spécifié
166 par une directive ErrorDocument pourrait contenir ce qui suit
169 <pre class="prettyprint lang-perl">...
170 print "Content-type: text/html\n";
171 printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"};
175 <p>Si un script est dédié à la gestion d'une condition d'erreur
176 spécifique, telle que <code>404 Not Found</code>, il
177 peut utiliser le code et le texte de l'erreur spécifiques à la
180 <p>Notez que si la réponse contient un en-tête
181 <code>Location:</code> (afin d'initier une redirection côté
182 client), le script <em>doit</em> émettre un en-tête approprié
183 (comme <code>302 Found</code>). Dans le cas contraire,
184 l'en-tête <code>Location:</code> ne produira aucun effet.</p>
185 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
186 <div class="section">
187 <h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalisés
188 multilingues</a></h2>
190 <p>Vous trouverez dans la distribution du serveur HTTP Apache un
191 répertoire contenant des messages d'erreur personnalisés traduits en
192 16 langues différentes. Pour activer cette fonctionnalité, vous
193 pouvez aussi inclure un fichier de configuration qui se trouve dans
194 le répertoire de configuration <code>conf/extra</code>.</p>
196 <p>Dans le fichier de configuration de votre serveur, vous trouverez
197 un groupe de lignes du style :</p>
199 <pre class="prettyprint lang-config"> # Multi-language error messages
200 #Include conf/extra/httpd-multilang-errordoc.conf</pre>
203 <p>Décommentez la ligne <code>Include</code> pour activer cette
204 fonctionnalité, et présenter des messages d'erreur dont le langage
205 sera négocié en fonction du langage préféré défini au niveau du
206 navigateur du client.</p>
208 <p>De plus, ces documents contiennent diverses variables
209 <code>REDIRECT_</code>, de façon à ce que l'utilisateur final
210 dispose d'informations supplémentaires à propos de ce qui a pu se
211 produire, et de ce qu'il est susceptible de faire maintenant.</p>
213 <p>Ces documents peuvent être personnalisés en fournissant autant
214 d'informations utiles que vous le souhaitez aux utilisateurs à
215 propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
217 <p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
218 <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>
221 <div class="bottomlang">
222 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
223 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
224 <a href="./fr/custom-error.html" title="Français"> fr </a> |
225 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
226 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
227 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
228 </div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
229 <script type="text/javascript"><!--//--><![CDATA[//><!--
230 var comments_shortname = 'httpd';
231 var comments_identifier = 'http://httpd.apache.org/docs/trunk/custom-error.html';
233 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
234 d.write('<div id="comments_thread"><\/div>');
235 var s = d.createElement('script');
236 s.type = 'text/javascript';
238 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
239 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
242 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
244 })(window, document);
245 //--><!]]></script></div><div id="footer">
246 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
247 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><
projects / apache / blob