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