rubbos/app/apache2/manual/handler.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>Utilisation des gestionnaires apache - 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.0</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.0</a></div><div id="page-content"><div id="preamble"><h1>Utilisation des gestionnaires apache</h1>
  20 <div class="toplang">
  21 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  23 <a href="./fr/handler.html" title="Français">&nbsp;fr&nbsp;</a> |
  24 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  25 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  26 <a href="./ru/handler.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a> |
  27 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  28 </div>
  29
  30     <p>Ce document décrit l'utilisation des gestionnaires (Handlers) Apache.</p>
  31   </div>
  32 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Qu'est ce qu'un Gestionnaire&nbsp;?</a></li>
  33 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
  34 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note aux programmeurs</a></li>
  35 </ul></div>
  36 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  37 <div class="section">
  38 <h2><a name="definition" id="definition">Qu'est ce qu'un Gestionnaire&nbsp;?</a></h2>
  39
  40     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
  41
  42
  43     <p>Un Gestionnaire "handler" est une représentation interne à
  44     Apache, qui décrit quoi faire quand un fichier est appelé. De
  45     manière générale, les fichiers disposent d'un gestionnaire
  46     implicite en fonction de leurs types. Le fonctionnement standard
  47     est de simplement servir le fichier tel qu'il est demandé, mais
  48     certains types de fichiers peuvent être gérés différemment.</p>
  49
  50     <p>Depuis Apache 1.1, il est possible de forcer l'utilisation
  51     des gestionnaires. Ils peuvent être spécifiés pour des fichiers
  52     présentant une certaine extension ou présents dans un certain
  53     répertoire, et peuvent être utilisés indépendamment des types
  54     des fichiers. Cette technique est avantageuse, d'abord parce
  55     que plus élégante, mais aussi parce qu'on peut ainsi associer
  56     un type de fichier <strong>et</strong> un gestionnaire à un
  57     fichier. (Voir aussi&nbsp;: <a href="mod/mod_mime.html#multipleext">Fichiers à Extensions Multiples</a>.)</p>
  58
  59     <p>Les gestionnaires peuvent être intégrés au serveur, ou inclus
  60     dans un module, ou encore être configurés au moyen de la directive
  61     <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Les
  62     gestionnaires fournis par défaut dans la distribution d'Apache
  63     se présentent comme suit&nbsp;:</p>
  64
  65     <ul>
  66       <li><strong>default-handler</strong>&nbsp;: Envoie le fichier en
  67       utilisant <code>default_handler()</code> qui est le
  68       gestionnaire utilisé par défaut pour gérer les contenus
  69       statiques. (noyau d'Apache)</li>
  70
  71       <li><strong>send-as-is</strong>&nbsp;: Envoie le fichier avec les
  72       en-têtes HTTP tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
  73
  74       <li><strong>cgi-script</strong>&nbsp;: Traite le fichier comme un
  75       script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
  76
  77       <li><strong>imap-file</strong>&nbsp;: Traite le fichier comme un
  78       ensemble de règles imagemap. NdT&nbsp;: ces fonctionnalités sont
  79       désuètes, et sont réalisées à présent coté client.
  80       (<code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code>)</li>
  81
  82       <li><strong>server-info</strong>&nbsp;: Envoie les informations
  83       de configuration du serveur. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
  84
  85       <li><strong>server-status</strong>&nbsp;: Envoie les informations sur
  86       le fonctionnement et la charge du serveur.
  87       (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
  88
  89       <li><strong>type-map</strong>&nbsp;: Traite le fichier comme un
  90       fichier de types pour la négociation de contenu.
  91       (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
  92     </ul>
  93   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  94 <div class="section">
  95 <h2><a name="examples" id="examples">Exemples</a></h2>
  96
  97
  98     <h3><a name="example1" id="example1">Modifier un contenu statique au moyen d'un script CGI</a></h3>
  99
 100
 101       <p>Les directives ci-après provoquent l'exécution du script
 102       CGI <code>footer.pl</code> à chaque requête de fichier
 103       présentant l'extension <code>html</code>.</p>
 104
 105       <div class="example"><p><code>
 106         Action add-footer /cgi-bin/footer.pl<br />
 107         AddHandler add-footer .html
 108       </code></p></div>
 109
 110       <p>Le travail du script CGI est alors d'envoyer le document
 111       demandé (désigné au moyen de la variable d'environnement
 112       <code>PATH_TRANSLATED</code>) en lui faisant subir au préalable
 113       les transformations désirées.</p>
 114
 115
 116     <h3><a name="example2" id="example2">Fichiers contenant des en-têtes HTTP</a></h3>
 117
 118
 119       <p>Les directives ci-après activent le gestionnaire
 120       <code>send-as-is</code>, utilisé pour gérer les fichiers
 121       qui contiennent leurs propres en-têtes HTTP. Tous les fichiers
 122       contenus dans le répertoire <code>/web/htdocs/asis/</code>
 123       seront traités par le gestionnaire <code>send-as-is</code>,
 124       sans tenir compte de leurs extensions.</p>
 125
 126       <div class="example"><p><code>
 127         &lt;Directory /web/htdocs/asis&gt;<br />
 128         SetHandler send-as-is<br />
 129         &lt;/Directory&gt;
 130       </code></p></div>
 131
 132
 133   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 134 <div class="section">
 135 <h2><a name="programmer" id="programmer">Note aux programmeurs</a></h2>
 136
 137
 138     <p>L'<a href="developer/API.html">API d'Apache</a> a été modifiée
 139     lors de l'implémentation des gestionnaires&nbsp;; cette modification
 140     peut se révéler intéressante. Un nouvel enregistrement a été ajouté
 141     à la structure <code>request_rec</code>&nbsp;:</p>
 142
 143     <div class="example"><p><code>
 144       char *handler
 145     </code></p></div>
 146
 147     <p>Pour qu'un module utilise un gestionnaire, il suffit d'affecter
 148     <code>r-&gt;handler</code> avec le nom du gestionnaire avant
 149     l'étape <code>invoke_handler</code> de la requête. Les
 150     gestionnaires fonctionnent comme auparavant, bien que leurs noms
 151     soient nécessaires au lieu d'un type de contenu. Bien qu'elle ne
 152     soit pas nécessaire, la convention de nommage des gestionnaires
 153     demande l'utilisation de mots séparés par des tirets, ne contenant
 154     aucun slash, afin de ne pas interférer avec l'espace de nommage
 155     des types de médias.</p>
 156   </div></div>
 157 <div class="bottomlang">
 158 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 159 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 160 <a href="./fr/handler.html" title="Français">&nbsp;fr&nbsp;</a> |
 161 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 162 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 163 <a href="./ru/handler.html" hreflang="ru" rel="alternate" title="Russian">&nbsp;ru&nbsp;</a> |
 164 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 165 </div><div id="footer">
 166 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 167 <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>
 168 </body></html>