mirror of
https://github.com/apache/httpd.git
synced 2025-10-31 19:10:37 +03:00
dc1f51bb92
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1357941 13f79535-47bb-0310-9956-ffa450edef68
192 lines
12 KiB
Plaintext
192 lines
12 KiB
Plaintext
<?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">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
|
||
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" />
|
||
<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" />
|
||
<script src="./style/scripts/prettify.js" type="text/javascript">
|
||
</script>
|
||
|
||
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
|
||
<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="http://wiki.apache.org/httpd/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.5</p>
|
||
<img alt="" src="./images/feather.gif" /></div>
|
||
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
|
||
<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.5</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> |
|
||
<a href="./es/handler.html" hreflang="es" rel="alternate" title="Espa<70>ol"> es </a> |
|
||
<a href="./fr/handler.html" title="Fran<61>ais"> fr </a> |
|
||
<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
||
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
|
||
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="T<>rk<72>e"> tr </a> |
|
||
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
|
||
</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>
|
||
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
|
||
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note du d<>veloppeur</a></li>
|
||
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></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<6E>s</th><th>Directives Apparent<6E>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<70>sentation interne <20> Apache de l'action
|
||
qui doit <20>tre entreprise quand un fichier est appel<65>. En g<>n<EFBFBD>ral, les
|
||
fichiers ont des gestionnaires implicites, bas<61>s sur le type du fichier.
|
||
Normalement, tous les fichiers sont trait<69>s simplement par le serveur,
|
||
mais certains types de fichiers sont "g<>r<EFBFBD>s" s<>par<61>ment.</p>
|
||
|
||
<p>Les gestionnaires peuvent aussi <20>tre configur<75>s explicitement,
|
||
soit en fonction des extensions des noms de fichier, soit en fonction
|
||
du chemin du fichier,
|
||
sans faire r<>f<EFBFBD>rence au type de fichier. Ceci a le double avantage d'<27>tre
|
||
une solution plus <20>l<EFBFBD>gante, et aussi d'autoriser <20> associer <20> 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 <20>tre soit partie int<6E>grante
|
||
du serveur ou inclus dans un module, soit ajout<75>s <20> l'aide de la directive
|
||
<code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Les gestionnaires
|
||
int<6E>gr<67>s dans la distribution standard se pr<70>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<69> par
|
||
d<>faut pour traiter les contenus statiques. (core)</li>
|
||
|
||
<li><strong>send-as-is</strong>: envoie les fichiers avec en-t<>tes HTTP
|
||
tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
|
||
|
||
<li><strong>cgi-script</strong>: traite le fichier comme un
|
||
script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
|
||
|
||
<li><strong>imap-file</strong>: Traite le fichier comme un ensemble
|
||
de r<>gles de descriptions d'images (imagemap).
|
||
(<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
|
||
|
||
<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
|
||
du serveur. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
|
||
|
||
<li><strong>type-map</strong>: Traite le fichier comme une description
|
||
de type pour la n<>gociation du contenu.
|
||
(<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
|
||
</ul>
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="examples" id="examples">Exemples</a></h2>
|
||
|
||
|
||
<h3><a name="example1" id="example1">Modification d'un contenu statique <20> l'aide d'un script CGI</a></h3>
|
||
|
||
|
||
<p>Les directives suivantes vont faire en sorte que les requ<71>tes pour
|
||
des fichiers poss<73>dant une extension <code>html</code> d<>clenchent
|
||
l'ex<65>cution du script CGI <code>footer.pl</code>.</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
Action add-footer /cgi-bin/footer.pl
|
||
AddHandler add-footer .html
|
||
</pre>
|
||
|
||
|
||
<p><3E> ce moment-l<>, le script CGI se charge d'envoyer le document
|
||
initialement demand<6E> (r<>f<EFBFBD>renc<6E> 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<69> pour les fichiers qui poss<73>dent
|
||
leurs propres en-t<>tes HTTP. Tous les fichiers situ<74>s dans le r<>pertoire
|
||
<code>/web/htdocs/asis/</code> seront trait<69>s par le gestionnaire
|
||
<code>send-as-is</code>, sans tenir compte de l'extension
|
||
de leur nom de fichier.</p>
|
||
|
||
<pre class="prettyprint lang-config">
|
||
<Directory /web/htdocs/asis>
|
||
SetHandler send-as-is
|
||
</Directory>
|
||
</pre>
|
||
|
||
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="programmer" id="programmer">Note du d<>veloppeur</a></h2>
|
||
|
||
|
||
<p>Pour impl<70>menter la fonctionnalit<69> des gestionnaires, l'
|
||
<a href="developer/API.html">API Apache</a> a fait l'objet d'un ajout
|
||
que vous pourriez <20>tre amen<65> <20> utiliser.
|
||
|
||
Plus pr<70>cis<69>ment, un nouvel enregistrement a <20>t<EFBFBD> ajout<75> <20> la structure
|
||
<code>request_rec</code> :</p>
|
||
|
||
<pre class="prettyprint lang-c">
|
||
char *handler
|
||
</pre>
|
||
|
||
|
||
<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 <20> n'importe quel moment avant l'<27>tape
|
||
<code>invoke_handler</code>
|
||
de la requ<71>te. Les gestionnaires sont impl<70>ment<6E>s comme auparavant,
|
||
quoique l'on utilise le nom du gestionnaire <20> 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<6F> s<>par<61> par des
|
||
tirets, sans slashes, afin de ne pas interf<72>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> |
|
||
<a href="./es/handler.html" hreflang="es" rel="alternate" title="Espa<70>ol"> es </a> |
|
||
<a href="./fr/handler.html" title="Fran<61>ais"> fr </a> |
|
||
<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
||
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
|
||
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="T<>rk<72>e"> tr </a> |
|
||
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
|
||
</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>
|
||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
var comments_shortname = 'httpd';
|
||
var comments_identifier = 'http://httpd.apache.org/docs/trunk/handler.html';
|
||
(function(w, d) {
|
||
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
||
d.write('<div id="comments_thread"><\/div>');
|
||
var s = d.createElement('script');
|
||
s.type = 'text/javascript';
|
||
s.async = true;
|
||
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
||
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
||
}
|
||
else {
|
||
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
||
}
|
||
})(window, document);
|
||
//--><!]]></script></div><div id="footer">
|
||
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris<69> 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="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[//><!--
|
||
if (typeof(prettyPrint) !== 'undefined') {
|
||
prettyPrint();
|
||
}
|
||
//--><!]]></script>
|
||
</body></html> |