granicus.if.org Git - apache/blob - docs/manual/handler.html.fr

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