2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision : 1174747 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
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
16 http://www.apache.org/licenses/LICENSE-2.0
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.
25 <modulesynopsis metafile="mod_actions.xml.meta">
27 <name>mod_actions</name>
29 <description>Ce module permet l'exécution des scripts CGI en fonction du
30 type de média ou de la méthode de requête.</description>
33 <sourcefile>mod_actions.c</sourcefile>
34 <identifier>actions_module</identifier>
37 <p>Ce module possède deux directives. La directive <directive
38 module="mod_actions">Action</directive> vous permet de lancer
39 l'exécution de scripts CGI chaque fois qu'un fichier possédant un
40 certain <glossary ref="mime-type">type de contenu MIME</glossary>
41 fait l'objet d'une requête. La directive <directive
42 module="mod_actions">Script</directive> vous permet de lancer
43 l'exécution de scripts CGI chaque fois que la requête utilise une
44 méthode particulière. Ceci facilite grandement l'exécution de
45 scripts qui traitent des fichiers.</p> </summary>
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>
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>
59 <context>server config</context><context>virtual host</context>
60 <context>directory</context><context>.htaccess</context>
62 <override>FileInfo</override>
63 <compatibility>Le modificateur <code>virtual</code> et le passage de
64 gestionnaire ont été introduits dans Apache 2.1</compatibility>
67 <p>Cette directive ajoute une action qui va activer <var>script
68 cgi</var> lorsque <var>type d'action</var> est déclenché par la
69 requête. <var>script cgi</var> est un chemin URL vers une ressource
70 qui a été désignée comme script CGI à 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 ê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és en utilisant
76 les variables d'environnement CGI standards <code>PATH_INFO</code>
77 et <code>PATH_TRANSLATED</code>. Le gestionnaire utilisé pour cette
78 requête particulière est transmis à l'aide de la variable
79 <code>REDIRECT_HANDLER</code>.</p>
81 <example><title>Exemple : type MIME</title>
82 # Requêtes concernant des fichiers possédant un type de contenu
83 # MIME particulier :<br />
84 Action image/gif /cgi-bin/images.cgi<br />
88 <p>Dans cet exemple, les requêtes pour des fichiers possédant
89 le type de contenu MIME <code>image/gif</code> seront traitées par
90 le script CGI <code>/cgi-bin/images.cgi</code>.</p>
92 <example><title>Example: extension de nom de fichier</title>
93 # Fichiers dont le nom possède une extension particulière<br />
94 AddHandler mon-type-de-fichier .xyz<br />
95 Action mon-type-de-fichier /cgi-bin/program.cgi<br />
98 <p>Dans cet exemple, les requêtes pour des fichiers possédant
99 l'extension <code>.xyz</code> seront traitées par
100 le script CGI <code>/cgi-bin/programme.cgi</code>.</p>
102 <p>Le modificateur optionnel <code>virtual</code> permet de
103 désactiver la vérification de l'existence du fichier demandé. Ceci
104 peut s'avérer utile, par exemple, si vous voulez utiliser la
105 directive <directive>Action</directive> pour des localisations
108 <example><title>Exemple</title>
109 <Location /news><br />
111 SetHandler news-handler<br />
112 Action news-handler /cgi-bin/news.cgi virtual<br />
118 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
123 <description>Active un script CGI dans le cas d'une méthode de requête
124 particulière.</description>
125 <syntax>Script <var>méthode</var> <var>script cgi</var></syntax>
127 <context>server config</context><context>virtual host</context>
128 <context>directory</context></contextlist>
130 <p>Cette directive ajoute une action qui va activer <var>script
131 cgi</var> lorsqu'un fichier est demandé en utilisant la méthode
132 <var>méthode</var>. <var>script cgi</var> est le chemin URL d'une
133 ressource qui a été désigné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é sont envoyés en utilisant les variables
138 d'environnement CGI standards <code>PATH_INFO</code> et
139 <code>PATH_TRANSLATED</code>.</p>
142 Tous les noms de méthode peuvent être utilisés. <strong>Les noms
143 de méthode sont sensibles à la casse</strong>, si bien que
144 <code>Script PUT</code> et <code>Script put</code> ont des effets
145 totalement différents.
148 <p>Notez que la commande <directive>Script</directive> ne définit
149 que des actions par défaut. Si un script CGI est appelé, ou toute
150 autre ressource capable de gérer la méthode de la requête en
151 interne, il agira en conséquence. Notez aussi que
152 <directive>Script</directive> avec une méthode <code>GET</code> ne
153 sera appelé que si la requête possède des arguments (par exemple
154 foo.html?hi). Dans le cas contraire, la requête sera traitée
157 <example><title>Exemples</title>
158 # Toutes les requêtes GET aboutissent ici<br />
159 Script GET /cgi-bin/search<br />
161 # Un gestionnaire CGI pour la méthode PUT<br />
162 Script PUT /~bob/put.cgi<br />