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" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Utilisation des gestionnaires d'Apache (handlers) - Serveur Apache HTTP 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">
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 Apache HTTP Version 2.5</p>
21 <img alt="" src="./images/feather.gif" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
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.5</a></div><div id="page-content"><div id="preamble"><h1>Utilisation des gestionnaires d'Apache (handlers)</h1>
26 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
27 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español"> es </a> |
28 <a href="./fr/handler.html" title="Français"> fr </a> |
29 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
30 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
31 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
32 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
35 <p>Ce document décrit l'utilisation des gestionnaires d'Apache (handlers).</p>
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><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>
43 <h2><a name="definition" id="definition">Qu'est-ce qu'un gestionnaire ?</a></h2>
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>
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>
54 <p>Les gestionnaires peuvent aussi être configurés explicitement,
55 soit en fonction des extensions des noms de fichier, soit en fonction
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
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>
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>
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>
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>
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>
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>
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>
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>
92 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
94 <h2><a name="examples" id="examples">Exemples</a></h2>
97 <h3><a name="example1" id="example1">Modification d'un contenu statique à l'aide d'un script CGI</a></h3>
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>
104 <pre class="prettyprint lang-config">Action add-footer /cgi-bin/footer.pl
105 AddHandler add-footer .html</pre>
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
114 <h3><a name="example2" id="example2">Fichiers avec en-têtes HTTP</a></h3>
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>
124 <pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
125 SetHandler send-as-is
126 </Directory></pre>
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></h2>
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.
139 Plus précisément, un nouvel enregistrement a été ajouté à la structure
140 <code>request_rec</code> :</p>
142 <pre class="prettyprint lang-c">char *handler</pre>
145 <p>Si vous voulez que votre module déclenche l'utilisation d'un
146 gestionnaire, il vous suffit de définir <code>r->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>
156 <div class="bottomlang">
157 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
158 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español"> es </a> |
159 <a href="./fr/handler.html" title="Français"> fr </a> |
160 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
161 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
162 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
163 <a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </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&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';
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';
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);
178 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
180 })(window, document);
181 //--><!]]></script></div><div id="footer">
182 <p class="apache">Copyright 2016 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') {