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