granicus.if.org Git - apache/blob - docs/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 d'Apache (handlers) - 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.3</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.3</a></div><div id="page-content"><div id="preamble"><h1>Utilisation des gestionnaires d'Apache (handlers)</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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  27 </div>
  28
  29     <p>Ce document décrit l'utilisation des gestionnaires d'Apache (handlers).</p>
  30   </div>
  31 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Qu'est-ce qu'un gestionnaire ?</a></li>
  32 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
  33 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note du développeur</a></li>
  34 </ul></div>
  35 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  36 <div class="section">
  37 <h2><a name="definition" id="definition">Qu'est-ce qu'un gestionnaire ?</a></h2>
  38
  39     <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_imagemap.html">mod_imagemap</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>
  40
  41
  42     <p>Un "gestionnaire" est une représentation interne à Apache de l'action
  43     qui doit être entreprise quand un fichier est appelé. En général, les
  44     fichiers ont des gestionnaires implicites, basés sur le type du fichier.
  45     Normalement, tous les fichiers sont traités simplement par le serveur,
  46     mais certains types de fichiers sont "gérés" séparément.</p>
  47
  48     <p>Les gestionnaires peuvent aussi être configurés explicitement,
  49     soit en fonction des extensions des noms de fichier, soit en fonction
  50     du chemin du fichier,
  51     sans faire référence au type de fichier. Ceci a le double avantage d'être
  52     une solution plus élégante, et aussi d'autoriser à associer à la fois
  53     un type <strong>et</strong> un gestionnaire avec un fichier. (Voir aussi <a href="mod/mod_mime.html#multipleext">Fichiers avec extensions
  54     multiples</a>.)</p>
  55
  56     <p>Les gestionnaires peuvent être soit partie intégrante
  57     du serveur ou inclus dans un module, soit ajoutés à l'aide de la directive
  58     <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Les gestionnaires
  59     intégrés dans la distribution standard se présentent comme suit :</p>
  60
  61     <ul>
  62       <li><strong>default-handler</strong>: envoie le fichier en utilisant
  63       le <code>default_handler()</code>, qui est le gestionnaire utilisé par
  64       défaut pour traiter les contenus statiques. (core)</li>
  65
  66       <li><strong>send-as-is</strong>: envoie les fichiers avec en-têtes HTTP
  67       tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
  68
  69       <li><strong>cgi-script</strong>: traite le fichier comme un
  70       script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
  71
  72       <li><strong>imap-file</strong>: Traite le fichier comme un ensemble
  73       de règles de descriptions d'images (imagemap).
  74       (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
  75
  76       <li><strong>server-info</strong>: Extrait des informations sur la
  77       configuration du serveur. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
  78
  79       <li><strong>server-status</strong>: Rédige un rapport sur le statut
  80       du serveur. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
  81
  82       <li><strong>type-map</strong>: Traite le fichier comme une description
  83       de type pour la négociation du contenu.
  84       (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
  85     </ul>
  86   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  87 <div class="section">
  88 <h2><a name="examples" id="examples">Exemples</a></h2>
  89
  90
  91     <h3><a name="example1" id="example1">Modification d'un contenu statique à l'aide d'un script CGI</a></h3>
  92
  93
  94       <p>Les directives suivantes vont faire en sorte que les requêtes pour
  95       des fichiers possédant une extension <code>html</code> déclenchent
  96       l'exécution du script CGI <code>footer.pl</code>.</p>
  97
  98       <div class="example"><p><code>
  99         Action add-footer /cgi-bin/footer.pl<br />
 100         AddHandler add-footer .html
 101       </code></p></div>
 102
 103       <p>À ce moment-là, le script CGI se charge d'envoyer le document
 104       initialement demandé (référencé par la variable d'environnement
 105       <code>PATH_TRANSLATED</code>) et d'effectuer tous ajout ou modification
 106       voulus.</p>
 107
 108
 109     <h3><a name="example2" id="example2">Fichiers avec en-têtes HTTP</a></h3>
 110
 111
 112       <p>Les directives suivantes vont activer le gestionnaire
 113       <code>send-as-is</code>, qui est utilisé pour les fichiers qui possèdent
 114       leurs propres en-têtes HTTP. Tous les fichiers situés dans le répertoire
 115       <code>/web/htdocs/asis/</code> seront traités par le gestionnaire
 116       <code>send-as-is</code>, sans tenir compte de l'extension
 117       de leur nom de fichier.</p>
 118
 119       <div class="example"><p><code>
 120         &lt;Directory /web/htdocs/asis&gt;<br />
 121         SetHandler send-as-is<br />
 122         &lt;/Directory&gt;
 123       </code></p></div>
 124
 125
 126   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 127 <div class="section">
 128 <h2><a name="programmer" id="programmer">Note du développeur</a></h2>
 129
 130
 131     <p>Pour implémenter la fonctionnalité des gestionnaires, l'
 132     <a href="developer/API.html">API Apache</a> a fait l'objet d'un ajout
 133     que vous pourriez être amené à utiliser.
 134
 135     Plus précisément, un nouvel enregistrement a été ajouté à la structure
 136     <code>request_rec</code> :</p>
 137
 138     <div class="example"><p><code>
 139       char *handler
 140     </code></p></div>
 141
 142     <p>Si vous voulez que votre module déclenche l'utilisation d'un
 143     gestionnaire, il vous suffit de définir <code>r-&gt;handler</code> avec
 144     le nom du gestionnaire à n'importe quel moment avant l'étape
 145     <code>invoke_handler</code>
 146     de la requête. Les gestionnaires sont implémentés comme auparavant,
 147     quoique l'on utilise le nom du gestionnaire à la place d'un type
 148     de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage
 149     des gestionnaires stipule l'utilisation d'un mot composé séparé par des
 150     tirets, sans slashes, afin de ne pas interférer avec l'espace de nommage
 151     des types de média.</p>
 152   </div></div>
 153 <div class="bottomlang">
 154 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 155 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 156 <a href="./fr/handler.html" title="Français">&nbsp;fr&nbsp;</a> |
 157 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 158 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 159 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 160 </div><div id="footer">
 161 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 162 <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>
 163 </body></html>