granicus.if.org Git - apache/blob - docs/manual/custom-error.html.fr

   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
   7       -->
   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" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
  12 <script src="./style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  16 <body id="manual-page"><div id="page-header">
  17 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.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>
  18 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  19 <img alt="" src="./images/feather.gif" /></div>
  20 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  21 <div id="path">
  22 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Messages d'erreur personnalisés</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  26 <a href="./fr/custom-error.html" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  30 </div>
  31 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
  32             anglaise pour les changements récents.</div>
  33
  34     <p>Le serveur HTTP Apache fournit des messages d'erreur génériques
  35     pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
  36     relativement austères, imprécis, et peuvent s'avérer intimidants
  37     pour les visiteurs du site. Si vous le souhaitez, vous pouvez
  38     afficher des messages d'erreur plus conviviaux, dans un langage
  39     autre que l'anglais, ou même sous une forme plus en adéquation avec
  40     le style de votre site.</p>
  41
  42     <p>Il est possible de définir des messages d'erreur personnalisés
  43     pour chaque code de statut HTTP associé à une condition d'erreur -
  44     c'est à dire tout code de statut 4xx ou 5xx.</p>
  45
  46     <p>De plus, il est possible de
  47     personnaliser le message d'erreur en fonction d'un jeu de valeurs
  48     fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté
  49     Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
  50     dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
  51     pour gérer les conditions d'erreur.</p>
  52
  53
  54   </div>
  55 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
  56 <li><img alt="" src="./images/down.gif" /> <a href="#variables">Variables disponibles</a></li>
  57 <li><img alt="" src="./images/down.gif" /> <a href="#custom">Personnalisation des messages d'erreur</a></li>
  58 <li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Messages d'erreur personnalisés
  59   multilingues</a></li>
  60 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  61 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  62 <div class="section">
  63 <h2><a name="configuration" id="configuration">Configuration</a></h2>
  64
  65     <p>Les messages d'erreur personnalisés sont configurés via la
  66     directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>, qui
  67     peut être utilisée dans un contexte global, serveur virtuel ou
  68     répertoire. On peut utiliser cette directive dans les fichiers
  69     .htaccess si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est
  70     définie à FileInfo.</p>
  71
  72     <div class="example"><p><code>
  73       ErrorDocument 500 "Désolé, notre script s'est crashé ; comme c'est
  74       dommage !"<br />
  75       ErrorDocument 500 /cgi-bin/crash-recover<br />
  76       ErrorDocument 500 http://erreur.example.com/erreur_serveur.html<br />
  77       ErrorDocument 404 /erreurs/non_trouve.html <br />
  78       ErrorDocument 401 /inscription/comment_s_inscrire.html
  79     </code></p></div>
  80
  81 <p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
  82       <div class="example"><p><code>
  83       ErrorDocument &lt;code_3_chiffres&gt; &lt;action&gt;
  84     </code></p></div>
  85       <p>où action peut être traitée comme :</p>
  86         <ol>
  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>
  92         </ol>
  93
  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>
  98
  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>
 102
 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>
 107
 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>
 113
 114       <p>Par exemple, en plus des variables d'environnement habituelles,
 115       vous pouvez recevoir ce qui suit :</p>
 116
 117
 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
 129       </code></p></div>
 130
 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>
 136
 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>
 141
 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>
 147
 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>
 151
 152
 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
 158         le message.</p>
 159
 160
 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
 167       :</p>
 168
 169       <div class="example"><p><code>
 170         ... <br />
 171         print  "Content-type: text/html\n"; <br />
 172         printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
 173         ...
 174       </code></p></div>
 175
 176       <p>Si un script est dédié à la gestion d'une condition d'erreur
 177       spécifique, telle que <code>404&nbsp;Not&nbsp;Found</code>, il
 178       peut utiliser le code et le texte de l'erreur spécifiques à la
 179       place.</p>
 180
 181       <p>Notez que si la réponse contient un en-tête
 182       <code>Location:</code> (afin d'initier une redirection côté
 183       client), le script <em>doit</em> émettre un en-tête approprié
 184       (comme <code>302&nbsp;Found</code>). Dans le cas contraire,
 185       l'en-tête <code>Location:</code> ne produira aucun effet.</p>
 186   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 187 <div class="section">
 188 <h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalisés
 189   multilingues</a></h2>
 190
 191     <p>Vous trouverez dans la distribution du serveur HTTP Apache un
 192     répertoire contenant des messages d'erreur personnalisés traduits en
 193     16 langues différentes. Pour activer cette fonctionnalité, vous
 194     pouvez aussi inclure un fichier de configuration qui se trouve dans
 195     le répertoire de configuration <code>conf/extra</code>.</p>
 196
 197     <p>Dans le fichier de configuration de votre serveur, vous trouverez
 198     un groupe de lignes du style :</p>
 199
 200     <div class="example"><p><code>
 201     # Multi-language error messages<br />
 202     #Include conf/extra/httpd-multilang-errordoc.conf
 203     </code></p></div>
 204
 205     <p>Décommentez la ligne <code>Include</code> pour activer cette
 206     fonctionnalité, et présenter des messages d'erreur dont le langage
 207     sera négocié en fonction du langage préféré défini au niveau du
 208     navigateur du client.</p>
 209
 210     <p>De plus, ces documents contiennent diverses variables
 211     <code>REDIRECT_</code>, de façon à ce que l'utilisateur final
 212     dispose d'informations supplémentaires à propos de ce qui a pu se
 213     produire, et de ce qu'il est susceptible de faire maintenant.</p>
 214
 215     <p>Ces documents peuvent être personnalisés en fournissant autant
 216     d'informations utiles que vous le souhaitez aux utilisateurs à
 217     propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
 218
 219     <p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
 220     <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
 222  </div></div>
 223 <div class="bottomlang">
 224 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 225 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 226 <a href="./fr/custom-error.html" title="Français">&nbsp;fr&nbsp;</a> |
 227 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 228 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 229 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 230 </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>This section is experimental!</strong><br />Comments placed here should not be expected
 231 to last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div><div id="disqus_thread" /><script type="text/javascript"><!--//--><![CDATA[//><!--
 232 var lang = 'fr';
 233 var disqus_shortname = 'httpd';
 234 var disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
 235 if (disqus_identifier.indexOf("httpd.apache.org") != -1) {
 236     (function() {
 237                 var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
 238                 dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
 239             (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
 240         })();
 241 } else {
 242     var text = document.createTextNode("Comments have been disabled for offline viewing.");
 243     document.getElementById('disqus_thread').appendChild(text);
 244 }
 245 //--><!]]></script></div><div id="footer">
 246 <p class="apache">Copyright 2012 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/directives.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"><!--//--><![CDATA[//><!--
 248 if (typeof(prettyPrint) !== undefined) {
 249     prettyPrint();
 250 }
 251 //--><!]]></script>
 252 </body></html>