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 apache - 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.0</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.0</a></div><div id="page-content"><div id="preamble"><h1>Utilisation des gestionnaires apache</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> |
26 <a href="./ru/handler.html" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
27 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
30 <p>Ce document décrit l'utilisation des gestionnaires (Handlers) Apache.</p>
32 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Qu'est ce qu'un Gestionnaire ?</a></li>
33 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
34 <li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note aux programmeurs</a></li>
36 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
38 <h2><a name="definition" id="definition">Qu'est ce qu'un Gestionnaire ?</a></h2>
40 <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_imap.html">mod_imap</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>
43 <p>Un Gestionnaire "handler" est une représentation interne à
44 Apache, qui décrit quoi faire quand un fichier est appelé. De
45 manière générale, les fichiers disposent d'un gestionnaire
46 implicite en fonction de leurs types. Le fonctionnement standard
47 est de simplement servir le fichier tel qu'il est demandé, mais
48 certains types de fichiers peuvent être gérés différemment.</p>
50 <p>Depuis Apache 1.1, il est possible de forcer l'utilisation
51 des gestionnaires. Ils peuvent être spécifiés pour des fichiers
52 présentant une certaine extension ou présents dans un certain
53 répertoire, et peuvent être utilisés indépendamment des types
54 des fichiers. Cette technique est avantageuse, d'abord parce
55 que plus élégante, mais aussi parce qu'on peut ainsi associer
56 un type de fichier <strong>et</strong> un gestionnaire à un
57 fichier. (Voir aussi : <a href="mod/mod_mime.html#multipleext">Fichiers à Extensions Multiples</a>.)</p>
59 <p>Les gestionnaires peuvent être intégrés au serveur, ou inclus
60 dans un module, ou encore être configurés au moyen de la directive
61 <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Les
62 gestionnaires fournis par défaut dans la distribution d'Apache
63 se présentent comme suit :</p>
66 <li><strong>default-handler</strong> : Envoie le fichier en
67 utilisant <code>default_handler()</code> qui est le
68 gestionnaire utilisé par défaut pour gérer les contenus
69 statiques. (noyau d'Apache)</li>
71 <li><strong>send-as-is</strong> : Envoie le fichier avec les
72 en-têtes HTTP tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
74 <li><strong>cgi-script</strong> : Traite le fichier comme un
75 script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
77 <li><strong>imap-file</strong> : Traite le fichier comme un
78 ensemble de règles imagemap. NdT : ces fonctionnalités sont
79 désuètes, et sont réalisées à présent coté client.
80 (<code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code>)</li>
82 <li><strong>server-info</strong> : Envoie les informations
83 de configuration du serveur. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
85 <li><strong>server-status</strong> : Envoie les informations sur
86 le fonctionnement et la charge du serveur.
87 (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
89 <li><strong>type-map</strong> : Traite le fichier comme un
90 fichier de types pour la négociation de contenu.
91 (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
93 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
95 <h2><a name="examples" id="examples">Exemples</a></h2>
98 <h3><a name="example1" id="example1">Modifier un contenu statique au moyen d'un script CGI</a></h3>
101 <p>Les directives ci-après provoquent l'exécution du script
102 CGI <code>footer.pl</code> à chaque requête de fichier
103 présentant l'extension <code>html</code>.</p>
105 <div class="example"><p><code>
106 Action add-footer /cgi-bin/footer.pl<br />
107 AddHandler add-footer .html
110 <p>Le travail du script CGI est alors d'envoyer le document
111 demandé (désigné au moyen de la variable d'environnement
112 <code>PATH_TRANSLATED</code>) en lui faisant subir au préalable
113 les transformations désirées.</p>
116 <h3><a name="example2" id="example2">Fichiers contenant des en-têtes HTTP</a></h3>
119 <p>Les directives ci-après activent le gestionnaire
120 <code>send-as-is</code>, utilisé pour gérer les fichiers
121 qui contiennent leurs propres en-têtes HTTP. Tous les fichiers
122 contenus dans le répertoire <code>/web/htdocs/asis/</code>
123 seront traités par le gestionnaire <code>send-as-is</code>,
124 sans tenir compte de leurs extensions.</p>
126 <div class="example"><p><code>
127 <Directory /web/htdocs/asis><br />
128 SetHandler send-as-is<br />
133 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
134 <div class="section">
135 <h2><a name="programmer" id="programmer">Note aux programmeurs</a></h2>
138 <p>L'<a href="developer/API.html">API d'Apache</a> a été modifiée
139 lors de l'implémentation des gestionnaires ; cette modification
140 peut se révéler intéressante. Un nouvel enregistrement a été ajouté
141 à la structure <code>request_rec</code> :</p>
143 <div class="example"><p><code>
147 <p>Pour qu'un module utilise un gestionnaire, il suffit d'affecter
148 <code>r->handler</code> avec le nom du gestionnaire avant
149 l'étape <code>invoke_handler</code> de la requête. Les
150 gestionnaires fonctionnent comme auparavant, bien que leurs noms
151 soient nécessaires au lieu d'un type de contenu. Bien qu'elle ne
152 soit pas nécessaire, la convention de nommage des gestionnaires
153 demande l'utilisation de mots séparés par des tirets, ne contenant
154 aucun slash, afin de ne pas interférer avec l'espace de nommage
155 des types de médias.</p>
157 <div class="bottomlang">
158 <p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
159 <a href="./es/handler.html" hreflang="es" rel="alternate" title="Español"> es </a> |
160 <a href="./fr/handler.html" title="Français"> fr </a> |
161 <a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
162 <a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
163 <a href="./ru/handler.html" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
164 <a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
165 </div><div id="footer">
166 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
167 <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>