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