docs/manual/custom-error.html.fr

	custom-error.html.fr revision 49acc6accb4061182ef84dc991aaa346ad01a8ec
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<?xml version="1.0" encoding="ISO-8859-1"?>
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht              This file is generated from xml source: DO NOT EDIT
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht      -->
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<title>Messages d'erreur personnalis�s - Serveur Apache HTTP</title>
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<link href="/images/favicon.ico" rel="shortcut icon" /></head>
0b152383e04dbeb10dba29bcdfaa0981e4d9df27Simon Ulbricht<body id="manual-page"><div id="page-header">
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht<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>
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht<p class="apache">Serveur Apache HTTP Version 2.3</p>
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht<img alt="" src="/images/feather.gif" /></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div id="path">
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<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.3</a></div><div id="page-content"><div id="preamble"><h1>Messages d'erreur personnalis�s</h1>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div class="toplang">
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<p><span>Langues Disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<a href="/es/custom-error.html" hreflang="es" rel="alternate" title="Espa�ol">&nbsp;es&nbsp;</a> |
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<a href="/fr/custom-error.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<a href="/ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<a href="/ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht<a href="/tr/custom-error.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht</div>
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    <p>Le serveur HTTP Apache fournit des messages d'erreur g�n�riques
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    relativement aust�res, impr�cis, et peuvent s'av�rer intimidants
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    pour les visiteurs du site. Si vous le souhaitez, vous pouvez
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    afficher des messages d'erreur plus conviviaux, dans un langage
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    autre que l'anglais, ou m�me sous une forme plus en ad�quation avec
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    le style de votre site.</p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    <p>Il est possible de d�finir des messages d'erreur personnalis�s
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    pour chaque code de statut HTTP associ� � une condition d'erreur -
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    c'est � dire tout code de statut 4xx ou 5xx.</p>
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    <p>De plus, il est possible de
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    personnaliser le message d'erreur en fonction d'un jeu de valeurs
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    fourni, en utilisant les <a href="howto/ssi.html">Inclusions C�t�
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
2643008447e30b6025f742eb6a661f38be756b1eSimon Ulbricht    pour g�rer les conditions d'erreur.</p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht  </div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#configuration">Configuration</a></li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<li><img alt="" src="/images/down.gif" /> <a href="#variables">Variables disponibles</a></li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<li><img alt="" src="/images/down.gif" /> <a href="#custom">Personnalisation des messages d'erreur</a></li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<li><img alt="" src="/images/down.gif" /> <a href="#multi-lang">Messages d'erreur personnalis�s
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht  multilingues</a></li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht</ul></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<div class="section">
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<h2><a name="configuration" id="configuration">Configuration</a></h2>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    <p>Les messages d'erreur personnalis�s sont configur�s via la
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    directive <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code>, qui
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    peut �tre utilis�e dans un contexte global, serveur virtuel ou
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    r�pertoire. On peut utiliser cette directive dans les fichiers
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    .htaccess si <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> est
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    d�finie � FileInfo.</p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    <div class="example"><p><code>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument 500 "D�sol�, notre script s'est crash� ; comme c'est
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      dommage !"<br />
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument 500 /cgi-bin/crash-recover<br />
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument 500 http://erreur.example.com/erreur_serveur.html<br />
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument 404 /erreurs/non_trouve.html <br />
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument 401 /inscription/comment_s_inscrire.html
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    </code></p></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht<p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      <div class="example"><p><code>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      ErrorDocument &lt;code_3_chiffres&gt; &lt;action&gt;
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    </code></p></div>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      <p>o� action peut �tre trait�e comme :</p>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht        <ol>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      <li>Une URL de redirection local (si l'action commence par un "/").</li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      <li>Une URL de redirection externe (si action est une URL valide).</li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      <li>Le texte � afficher (si l'action ne r�pond � aucune des
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      deux conditions pr�c�dentes). Entourez le texte de guillemets (")
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht      s'il contient plusieurs mots.</li>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht        </ol>
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    <p>Dans le cas d'une redirection vers une URL locale, des variables
d815d2b83e945875100ceca322ebd50d96714206Simon Ulbricht    d'environnement suppl�mentaires sont d�finies de fa�on � ce que la
    r�ponse puisse �tre personnalis�e par la suite. Elles ne sont pas
    envoy�es aux URLs externes.</p>

  </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Variables disponibles</a></h2>

      <p>La redirection vers une autre URL peut �tre utile, mais
      seulement s'il est possible de transmettre certaines informations
      qui pourront �tre utilis�es pour expliquer ou journaliser
      la condition d'erreur ou le probl�me plus clairement.</p>

    <p>Pour y parvenir, lorsque la redirection d'erreur est envoy�e,
    des variables d'environnement suppl�mentaires sont d�finies �
    partir des en-t�tes de la requ�te originale en pr�fixant le nom
    d'origine de l'en-t�te par 'REDIRECT_', ce qui permet de fournir au
    message d'erreur le contexte de la requ�te originelle.</p>

      <p>Par exemple, en plus des variables d'environnement habituelles,
      vous pouvez recevoir ce qui suit :</p>


      <div class="example"><p><code>
        REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
        REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
        REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
        REDIRECT_QUERY_STRING=<br />
        REDIRECT_REMOTE_ADDR=121.345.78.123<br />
        REDIRECT_REMOTE_HOST=client.example.com<br />
        REDIRECT_SERVER_NAME=www.example.edu<br />
        REDIRECT_SERVER_PORT=80<br />
        REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
        REDIRECT_URL=/cgi-bin/buggy.pl
      </code></p></div>

      <p>Les variables d'environnement <code>REDIRECT_</code> sont
      cr��es � partir des variables d'environnement pr�existantes � la
      redirection qui sont pr�fix�es par la cha�ne <code>REDIRECT_</code> ;
      par exemple, <code>HTTP_USER_AGENT</code> devient
      <code>REDIRECT_HTTP_USER_AGENT</code>.</p>

      <p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
      <code>REDIRECT_QUERY_STRING</code> sont syst�matiquement d�finies,
      les autres variables n'�tant d�finies que si l'en-t�te
      correspondant existait avant la condition d'erreur.</p>

      <p><strong>Aucune</strong> d'entre elles ne sera d�finie si votre
      directive <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code>
      sp�cifie une redirection <em>externe</em> (toute URL commen�ant
      par un protocole du style <code>http:</code>, m�me si elle fait
      r�f�rence au m�me h�te que le serveur).</p>

  </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">Personnalisation des messages d'erreur</a></h2>


    <p>Si vous faites pointer votre directive
    <code>ErrorDocument</code> vers certains gestionnaires
    dynamiques comme les inclusions c�t� serveur, les scripts CGI ou
    d'autres gestionnaires, vous pouvez utiliser les variables
    d'environnement suppl�mentaires disponibles pour personnaliser
    le message.</p>


      <p>Si la directive ErrorDname-basedocument sp�cifie une redirection locale
      vers un script CGI, ce dernier doit ajouter un en-t�te
      "<code>Status:</code>" dans sa sortie afin de s'assurer du bon
      acheminement jusqu'au client de la condition d'erreur qui a
      provoqu� cette redirection. Par exemple, un script Perl sp�cifi�
      par une directive ErrorDocument pourrait contenir ce qui suit
      :</p>

      <div class="example"><p><code>
        ... <br />
        print  "Content-type: text/html\n"; <br />
        printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
        ...
      </code></p></div>

      <p>Si un script est d�di� � la gestion d'une condition d'erreur
      sp�cifique, telle que <code>404&nbsp;Not&nbsp;Found</code>, il
      peut utiliser le code et le texte de l'erreur sp�cifiques � la
      place.</p>

      <p>Notez que si la r�ponse contient un en-t�te
      <code>Location:</code> (afin d'initier une redirection c�t�
      client), le script <em>doit</em> �mettre un en-t�te appropri�
      (comme <code>302&nbsp;Found</code>). Dans le cas contraire,
      l'en-t�te <code>Location:</code> ne produira aucun effet.</p>
  </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalis�s
  multilingues</a></h2>

    <p>Vous trouverez dans la distribution du serveur HTTP Apache un
    r�pertoire contenant des messages d'erreur personnalis�s traduits en
    16 langues diff�rentes. Pour activer cette fonctionnalit�, vous
    pouvez aussi inclure un fichier de configuration qui se trouve dans
    le r�pertoire de configuration <code>conf/extra</code>.</p>

    <p>Dans le fichier de configuration de votre serveur, vous trouverez
    un groupe de lignes du style :</p>

    <div class="example"><p><code>
    # Multi-language error messages<br />
    #Include conf/extra/httpd-multilang-errordoc.conf
    </code></p></div>

    <p>D�commentez la ligne <code>Include</code> pour activer cette
    fonctionnalit�, et pr�senter des messages d'erreur dont le langage
    sera n�goci� en fonction du langage pr�f�r� d�fini au niveau du
    navigateur du client.</p>

    <p>De plus, ces documents contiennent diverses variables
    <code>REDIRECT_</code>, de fa�on � ce que l'utilisateur final
    dispose d'informations suppl�mentaires � propos de ce qui a pu se
    produire, et de ce qu'il est susceptible de faire maintenant.</p>

    <p>Ces documents peuvent �tre personnalis�s en fournissant autant
    d'informations utiles que vous le souhaitez aux utilisateurs �
    propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>

    <p>Pour pouvoir utiliser cette fonctionnalit�, vous devez activer
    <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>

 </div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/es/custom-error.html" hreflang="es" rel="alternate" title="Espa�ol">&nbsp;es&nbsp;</a> |
<a href="/fr/custom-error.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/custom-error.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<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>
</body></html>