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" />
  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.5</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <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>
  20 <div class="toplang">
  21 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  23 <a href="./fr/custom-error.html" title="Français">&nbsp;fr&nbsp;</a> |
  24 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  25 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  26 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  27 </div>
  28
  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>
  36
  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>
  40
  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>
  47
  48
  49   </div>
  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
  54   multilingues</a></li>
  55 </ul></div>
  56 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  57 <div class="section">
  58 <h2><a name="configuration" id="configuration">Configuration</a></h2>
  59
  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>
  66
  67     <div class="example"><p><code>
  68       ErrorDocument 500 "Désolé, notre script s'est crashé ; comme c'est
  69       dommage !"<br />
  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
  74     </code></p></div>
  75
  76 <p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
  77       <div class="example"><p><code>
  78       ErrorDocument &lt;code_3_chiffres&gt; &lt;action&gt;
  79     </code></p></div>
  80       <p>où action peut être traitée comme :</p>
  81         <ol>
  82       <li>Une URL de redirection local (si l'action commence par un "/").</li>
  83       <li>Une URL de redirection externe (si action est une URL valide).</li>
  84       <li>Le texte à afficher (si l'action ne répond à aucune des
  85       deux conditions précédentes). Entourez le texte de guillemets (")
  86       s'il contient plusieurs mots.</li>
  87         </ol>
  88
  89     <p>Dans le cas d'une redirection vers une URL locale, des variables
  90     d'environnement supplémentaires sont définies de façon à ce que la
  91     réponse puisse être personnalisée par la suite. Elles ne sont pas
  92     envoyées aux URLs externes.</p>
  93
  94   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  95 <div class="section">
  96 <h2><a name="variables" id="variables">Variables disponibles</a></h2>
  97
  98       <p>La redirection vers une autre URL peut être utile, mais
  99       seulement s'il est possible de transmettre certaines informations
 100       qui pourront être utilisées pour expliquer ou journaliser
 101       la condition d'erreur ou le problème plus clairement.</p>
 102
 103         <p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,
 104         des variables d'environnement supplémentaires sont définies à
 105         partir des en-têtes de la requête originale en préfixant le nom
 106         d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au
 107         message d'erreur le contexte de la requête originelle.</p>
 108
 109       <p>Par exemple, en plus des variables d'environnement habituelles,
 110       vous pouvez recevoir ce qui suit :</p>
 111
 112
 113       <div class="example"><p><code>
 114         REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
 115         REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
 116         REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
 117         REDIRECT_QUERY_STRING=<br />
 118         REDIRECT_REMOTE_ADDR=121.345.78.123<br />
 119         REDIRECT_REMOTE_HOST=client.example.com<br />
 120         REDIRECT_SERVER_NAME=www.example.edu<br />
 121         REDIRECT_SERVER_PORT=80<br />
 122         REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
 123         REDIRECT_URL=/cgi-bin/buggy.pl
 124       </code></p></div>
 125
 126       <p>Les variables d'environnement <code>REDIRECT_</code> sont
 127       créées à partir des variables d'environnement préexistantes à la
 128       redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;
 129       par exemple, <code>HTTP_USER_AGENT</code> devient
 130       <code>REDIRECT_HTTP_USER_AGENT</code>.</p>
 131
 132       <p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
 133       <code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,
 134       les autres variables n'étant définies que si l'en-tête
 135       correspondant existait avant la condition d'erreur.</p>
 136
 137       <p><strong>Aucune</strong> d'entre elles ne sera définie si votre
 138       directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
 139       spécifie une redirection <em>externe</em> (toute URL commençant
 140       par un protocole du style <code>http:</code>, même si elle fait
 141       référence au même hôte que le serveur).</p>
 142
 143   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 144 <div class="section">
 145 <h2><a name="custom" id="custom">Personnalisation des messages d'erreur</a></h2>
 146
 147
 148         <p>Si vous faites pointer votre directive
 149         <code>ErrorDocument</code> vers certains gestionnaires
 150         dynamiques comme les inclusions côté serveur, les scripts CGI ou
 151         d'autres gestionnaires, vous pouvez utiliser les variables
 152         d'environnement supplémentaires disponibles pour personnaliser
 153         le message.</p>
 154
 155
 156       <p>Si la directive ErrorDname-basedocument spécifie une redirection locale
 157       vers un script CGI, ce dernier doit ajouter un en-tête
 158       "<code>Status:</code>" dans sa sortie afin de s'assurer du bon
 159       acheminement jusqu'au client de la condition d'erreur qui a
 160       provoqué cette redirection. Par exemple, un script Perl spécifié
 161       par une directive ErrorDocument pourrait contenir ce qui suit
 162       :</p>
 163
 164       <div class="example"><p><code>
 165         ... <br />
 166         print  "Content-type: text/html\n"; <br />
 167         printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
 168         ...
 169       </code></p></div>
 170
 171       <p>Si un script est dédié à la gestion d'une condition d'erreur
 172       spécifique, telle que <code>404&nbsp;Not&nbsp;Found</code>, il
 173       peut utiliser le code et le texte de l'erreur spécifiques à la
 174       place.</p>
 175
 176       <p>Notez que si la réponse contient un en-tête
 177       <code>Location:</code> (afin d'initier une redirection côté
 178       client), le script <em>doit</em> émettre un en-tête approprié
 179       (comme <code>302&nbsp;Found</code>). Dans le cas contraire,
 180       l'en-tête <code>Location:</code> ne produira aucun effet.</p>
 181   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 182 <div class="section">
 183 <h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalisés
 184   multilingues</a></h2>
 185
 186     <p>Vous trouverez dans la distribution du serveur HTTP Apache un
 187     répertoire contenant des messages d'erreur personnalisés traduits en
 188     16 langues différentes. Pour activer cette fonctionnalité, vous
 189     pouvez aussi inclure un fichier de configuration qui se trouve dans
 190     le répertoire de configuration <code>conf/extra</code>.</p>
 191
 192     <p>Dans le fichier de configuration de votre serveur, vous trouverez
 193     un groupe de lignes du style :</p>
 194
 195     <div class="example"><p><code>
 196     # Multi-language error messages<br />
 197     #Include conf/extra/httpd-multilang-errordoc.conf
 198     </code></p></div>
 199
 200     <p>Décommentez la ligne <code>Include</code> pour activer cette
 201     fonctionnalité, et présenter des messages d'erreur dont le langage
 202     sera négocié en fonction du langage préféré défini au niveau du
 203     navigateur du client.</p>
 204
 205     <p>De plus, ces documents contiennent diverses variables
 206     <code>REDIRECT_</code>, de façon à ce que l'utilisateur final
 207     dispose d'informations supplémentaires à propos de ce qui a pu se
 208     produire, et de ce qu'il est susceptible de faire maintenant.</p>
 209
 210     <p>Ces documents peuvent être personnalisés en fournissant autant
 211     d'informations utiles que vous le souhaitez aux utilisateurs à
 212     propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
 213
 214     <p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
 215     <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
 217  </div></div>
 218 <div class="bottomlang">
 219 <p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 220 <a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 221 <a href="./fr/custom-error.html" title="Français">&nbsp;fr&nbsp;</a> |
 222 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 223 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 224 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 225 </div><div id="footer">
 226 <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>
 227 <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>
 228 </body></html>