granicus.if.org Git - apache/blob - docs/manual/mod/mod_actions.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1103989 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_actions.xml.meta">
  26
  27 <name>mod_actions</name>
  28
  29 <description>Ce module permet l'ex&eacute;cution des scripts CGI en fonction du
  30 type de m&eacute;dia ou de la m&eacute;thode de requ&ecirc;te.</description>
  31
  32 <status>Base</status>
  33 <sourcefile>mod_actions.c</sourcefile>
  34 <identifier>actions_module</identifier>
  35
  36 <summary>
  37     <p>Ce module poss&egrave;de deux directives. La directive <directive
  38     module="mod_actions">Action</directive> vous permet de lancer
  39     l'ex&eacute;cution de scripts CGI chaque fois qu'un fichier poss&eacute;dant un
  40     certain <glossary ref="mime-type">type de contenu MIME</glossary>
  41     fait l'objet d'une requ&ecirc;te. La directive <directive
  42     module="mod_actions">Script</directive> vous permet de lancer
  43     l'ex&eacute;cution de scripts CGI chaque fois que la requ&ecirc;te utilise une
  44     m&eacute;thode particuli&egrave;re. Ceci facilite grandement l'ex&eacute;cution de
  45     scripts qui traitent des fichiers.</p> </summary>
  46
  47 <seealso><module>mod_cgi</module></seealso>
  48 <seealso><a href="../howto/cgi.html">Contenu dynamique avec CGI</a></seealso>
  49 <seealso><a href="../handler.html">Utilisation des gestionnaires
  50 d'Apache httpd</a></seealso>
  51
  52 <directivesynopsis>
  53 <name>Action</name>
  54 <description>Active un script CGI pour un gestionnaire ou un type de
  55 contenu particulier</description>
  56 <syntax>Action <var>type d'action</var> <var>script cgi</var>
  57 [virtual]</syntax>
  58 <contextlist>
  59 <context>server config</context><context>virtual host</context>
  60 <context>directory</context><context>.htaccess</context>
  61 </contextlist>
  62 <override>FileInfo</override>
  63 <compatibility>Le modificateur <code>virtual</code> et le passage de
  64 gestionnaire ont &eacute;t&eacute; introduits dans Apache 2.1</compatibility>
  65
  66 <usage>
  67     <p>Cette directive ajoute une action qui va activer <var>script
  68     cgi</var> lorsque <var>type d'action</var> est d&eacute;clench&eacute; par la
  69     requ&ecirc;te. <var>script cgi</var> est un chemin URL vers une ressource
  70     qui a &eacute;t&eacute; d&eacute;sign&eacute;e comme script CGI &agrave; l'aide des directives
  71     <directive module="mod_alias">ScriptAlias</directive> ou <directive
  72     module="mod_mime">AddHandler</directive>. <var>type d'action</var>
  73     peut &ecirc;tre soit un <a href="../handler.html">gestionnaire</a>, soit
  74     un <glossary ref="mime-type">type de contenu MIME</glossary>. L'URL
  75     et le chemin du document correspondant sont envoy&eacute;s en utilisant
  76     les variables d'environnement CGI standards <code>PATH_INFO</code>
  77     et <code>PATH_TRANSLATED</code>. Le gestionnaire utilis&eacute; pour cette
  78     requ&ecirc;te particuli&egrave;re est transmis &agrave; l'aide de la variable
  79     <code>REDIRECT_HANDLER</code>.</p>
  80
  81     <example><title>Exemple : type MIME</title>
  82       # Requ&ecirc;tes concernant des fichiers poss&eacute;dant un type de contenu
  83       # MIME particulier :<br />
  84       Action image/gif /cgi-bin/images.cgi<br />
  85       <br />
  86     </example>
  87
  88     <p>Dans cet exemple, les requ&ecirc;tes pour des fichiers poss&eacute;dant
  89     le type de contenu MIME <code>image/gif</code> seront trait&eacute;es par
  90     le script CGI <code>/cgi-bin/images.cgi</code>.</p>
  91
  92     <example><title>Example: extension de nom de fichier</title>
  93       # Fichiers dont le nom poss&egrave;de une extension particuli&egrave;re<br />
  94       AddHandler mon-type-de-fichier .xyz<br />
  95       Action mon-type-de-fichier /cgi-bin/program.cgi<br />
  96     </example>
  97
  98     <p>Dans cet exemple, les requ&ecirc;tes pour des fichiers poss&eacute;dant
  99     l'extension <code>.xyz</code> seront trait&eacute;es par
 100     le script CGI <code>/cgi-bin/programme.cgi</code>.</p>
 101
 102     <p>Le modificateur optionnel <code>virtual</code> permet de
 103     d&eacute;sactiver la v&eacute;rification de l'existence du fichier demand&eacute;. Ceci
 104     peut s'av&eacute;rer utile, par exemple, si vous voulez utiliser la
 105     directive <directive>Action</directive> pour des localisations
 106     virtuelles.</p>
 107
 108     <example><title>Exemple</title>
 109       &lt;Location /news&gt;<br />
 110       <indent>
 111         SetHandler news-handler<br />
 112         Action news-handler /cgi-bin/news.cgi virtual<br />
 113       </indent>
 114       &lt;/Location&gt;
 115     </example>
 116 </usage>
 117
 118 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
 119 </directivesynopsis>
 120
 121 <directivesynopsis>
 122 <name>Script</name>
 123 <description>Active un script CGI dans le cas d'une m&eacute;thode de requ&ecirc;te
 124 particuli&egrave;re.</description>
 125 <syntax>Script <var>m&eacute;thode</var> <var>script cgi</var></syntax>
 126 <contextlist>
 127 <context>server config</context><context>virtual host</context>
 128 <context>directory</context></contextlist>
 129 <usage>
 130     <p>Cette directive ajoute une action qui va activer <var>script
 131     cgi</var> lorsqu'un fichier est demand&eacute; en utilisant la m&eacute;thode
 132     <var>m&eacute;thode</var>. <var>script cgi</var> est le chemin URL d'une
 133     ressource qui a &eacute;t&eacute; d&eacute;sign&eacute;e comme script CGI en utilisant les
 134     directives <directive
 135     module="mod_alias">ScriptAlias</directive> ou <directive
 136     module="mod_mime">AddHandler</directive>. L'URL et le chemin du
 137     document demand&eacute; sont envoy&eacute;s en utilisant les variables
 138     d'environnement CGI standards <code>PATH_INFO</code> et
 139     <code>PATH_TRANSLATED</code>.</p>
 140
 141     <note>
 142       Tous les noms de m&eacute;thode peuvent &ecirc;tre utilis&eacute;s. <strong>Les noms
 143       de m&eacute;thode sont sensibles &agrave; la casse</strong>, si bien que
 144       <code>Script PUT</code> et <code>Script put</code> ont des effets
 145       totalement diff&eacute;rents.
 146     </note>
 147
 148     <p>Notez que la commande <directive>Script</directive> ne d&eacute;finit
 149     que des actions par d&eacute;faut. Si un script CGI est appel&eacute;, ou toute
 150     autre ressource capable de g&eacute;rer la m&eacute;thode de la requ&ecirc;te en
 151     interne, il agira en cons&eacute;quence. Notez aussi que
 152     <directive>Script</directive> avec une m&eacute;thode <code>GET</code> ne
 153     sera appel&eacute; que si la requ&ecirc;te poss&egrave;de des arguments (par exemple
 154     foo.html?hi). Dans le cas contraire, la requ&ecirc;te sera trait&eacute;e
 155     normalement.</p>
 156
 157     <example><title>Exemples</title>
 158       # Toutes les requ&ecirc;tes GET aboutissent ici<br />
 159       Script GET /cgi-bin/search<br />
 160       <br />
 161       # Un gestionnaire CGI pour la m&eacute;thode PUT<br />
 162       Script PUT /~bob/put.cgi<br />
 163     </example>
 164 </usage>
 165 </directivesynopsis>
 166
 167 </modulesynopsis>