handler.html.fr revision 282b62d8e9a4edbc2da22ba2d876ec94afc48084
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utilisation des gestionnaires d'Apache (handlers) - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<div id="path">
<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>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div>
<p>Ce document d�crit l'utilisation des gestionnaires d'Apache (handlers).</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#definition">Qu'est-ce qu'un gestionnaire ?</a></li>
</ul></div>
<div class="section">
<h2><a name="definition" id="definition">Qu'est-ce qu'un gestionnaire ?</a></h2>
<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>
<p>Un "gestionnaire" est une repr�sentation interne � Apache de l'action
qui doit �tre entreprise quand un fichier est appel�. En g�n�ral, les
fichiers ont des gestionnaires implicites, bas�s sur le type du fichier.
Normalement, tous les fichiers sont trait�s simplement par le serveur,
mais certains types de fichiers sont "g�r�s" s�par�ment.</p>
<p>Les gestionnaires peuvent aussi �tre configur�s explicitement,
soit en fonction des extensions des noms de fichier, soit en fonction
du chemin du fichier,
sans faire r�f�rence au type de fichier. Ceci a le double avantage d'�tre
une solution plus �l�gante, et aussi d'autoriser � associer � la fois
un type <strong>et</strong> un gestionnaire avec un fichier. (Voir aussi <a href="mod/mod_mime.html#multipleext">Fichiers avec extensions
multiples</a>.)</p>
<p>Les gestionnaires peuvent �tre soit partie int�grante
du serveur ou inclus dans un module, soit ajout�s � l'aide de la directive
int�gr�s dans la distribution standard se pr�sentent comme suit :</p>
<ul>
<li><strong>default-handler</strong>: envoie le fichier en utilisant
le <code>default_handler()</code>, qui est le gestionnaire utilis� par
d�faut pour traiter les contenus statiques. (core)</li>
<li><strong>send-as-is</strong>: envoie les fichiers avec en-t�tes HTTP
<li><strong>cgi-script</strong>: traite le fichier comme un
<li><strong>imap-file</strong>: Traite le fichier comme un ensemble
de r�gles de descriptions d'images (imagemap).
<li><strong>server-info</strong>: Extrait des informations sur la
configuration du serveur. (<code class="module"><a href="/mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: R�dige un rapport sur le statut
<li><strong>type-map</strong>: Traite le fichier comme une description
de type pour la n�gociation du contenu.
</ul>
<div class="section">
<h2><a name="examples" id="examples">Exemples</a></h2>
<h3><a name="example1" id="example1">Modification d'un contenu statique � l'aide d'un script CGI</a></h3>
<p>Les directives suivantes vont faire en sorte que les requ�tes pour
des fichiers poss�dant une extension <code>html</code> d�clenchent
<div class="example"><p><code>
AddHandler add-footer .html
</code></p></div>
<p>� ce moment-l�, le script CGI se charge d'envoyer le document
initialement demand� (r�f�renc� par la variable d'environnement
<code>PATH_TRANSLATED</code>) et d'effectuer tous ajout ou modification
voulus.</p>
<h3><a name="example2" id="example2">Fichiers avec en-t�tes HTTP</a></h3>
<p>Les directives suivantes vont activer le gestionnaire
<code>send-as-is</code>, qui est utilis� pour les fichiers qui poss�dent
leurs propres en-t�tes HTTP. Tous les fichiers situ�s dans le r�pertoire
<code>send-as-is</code>, sans tenir compte de l'extension
de leur nom de fichier.</p>
<div class="example"><p><code>
SetHandler send-as-is<br />
</Directory>
</code></p></div>
<div class="section">
<h2><a name="programmer" id="programmer">Note du d�veloppeur</a></h2>
<p>Pour impl�menter la fonctionnalit� des gestionnaires, l'
que vous pourriez �tre amen� � utiliser.
Plus pr�cis�ment, un nouvel enregistrement a �t� ajout� � la structure
<code>request_rec</code> :</p>
<div class="example"><p><code>
char *handler
</code></p></div>
<p>Si vous voulez que votre module d�clenche l'utilisation d'un
gestionnaire, il vous suffit de d�finir <code>r->handler</code> avec
le nom du gestionnaire � n'importe quel moment avant l'�tape
<code>invoke_handler</code>
de la requ�te. Les gestionnaires sont impl�ment�s comme auparavant,
quoique l'on utilise le nom du gestionnaire � la place d'un type
de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage
des gestionnaires stipule l'utilisation d'un mot compos� s�par� par des
tirets, sans slashes, afin de ne pas interf�rer avec l'espace de nommage
des types de m�dia.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div><div id="footer">
<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>
<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>
</body></html>