-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1330988 -->
+<!-- English Revision: 1793934 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
limitations under the License.
-->
-<modulesynopsis metafile="mod_example.xml.meta">
+<modulesynopsis metafile="mod_example_hooks.xml.meta">
-<name>mod_example</name>
+<name>mod_example_hooks</name>
<description>Illustration de l'API des modules Apache</description>
<status>Experimental</status>
-<sourcefile>mod_example.c</sourcefile>
-<identifier>example_module</identifier>
+<sourcefile>mod_example_hooks.c</sourcefile>
+<identifier>example_hooks_module</identifier>
<summary>
- <p>Certains fichiers situés dans le répertoire
- <code>modules/experimental</code> de l'arborescence de la
- distribution d'Apache sont fournis à titre d'exemples pour ceux qui
- souhaitent écrire des modules qui utilisent l'API d'Apache.</p>
-
- <p>Le fichier principal est <code>mod_example.c</code>, qui
- constitue une illustration exhaustive des différents mécanismes et
- syntaxes d'appels. En aucun cas un module additionnel n'aura à
- inclure des routines pour tous les appels - il n'en nécessitera au
+ <p>Certains fichiers situés dans le répertoire
+ <code>modules/examples</code> de l'arborescence de la
+ distribution d'Apache sont fournis à titre d'exemples pour ceux qui
+ souhaitent écrire des modules qui utilisent l'API d'Apache.</p>
+
+ <p>Le fichier principal est <code>mod_example_hooks.c</code>, qui
+ constitue une illustration exhaustive des différents mécanismes et
+ syntaxes d'appels. En aucun cas un module additionnel n'aura à
+ inclure des routines pour tous les appels - il n'en nécessitera au
contraire qu'un petit nombre !</p>
- <p>Le module example fonctionne réellement. Si vous le chargez dans
- votre serveur, activez le gestionnaire "example-handler" dans une
- section location, et essayez d'accéder à la zone du site web
+ <p>Le module example_hooks fonctionne réellement. Si vous le chargez dans
+ votre serveur, activez le gestionnaire "example-hooks-handler" dans une
+ section location, et essayez d'accéder à la zone du site web
correspondante, vous verrez s'afficher certaines sorties que le
- module example produit au cours des différents appels.</p>
+ module example_hooks produit au cours des différents appels.</p>
</summary>
-<section id="compiling"><title>Compilation du module example</title>
+<section id="compiling"><title>Compilation du module example_hooks</title>
- <p>Pour inclure le module example dans votre serveur, effectuez les
- étapes suivantes :</p>
+ <p>Pour inclure le module example_hooks dans votre serveur, effectuez les
+ étapes suivantes :</p>
<ol>
- <li>Exécutez <program>configure</program> avec l'option
- <code>--enable-example</code>.</li>
+ <li>Exécutez <program>configure</program> avec l'option
+ <code>--enable-example-hooks</code>.</li>
- <li>Compilez le serveur (exécutez la commande
+ <li>Compilez le serveur (exécutez la commande
"<code>make</code>").</li>
</ol>
<p>Pour ajouter votre propre module :</p>
<ol type="A">
- <li><code>cp modules/experimental/mod_example.c
+ <li><code>cp modules/examples/mod_example_hooks.c
modules/nouveau_module/<em>mod_monexemple.c</em></code></li>
<li>Modifiez le fichier.</li>
- <li>Créez <code>modules/nouveau_module/config.m4</code>.
+ <li>Créez <code>modules/nouveau_module/config.m4</code>.
<ol>
<li>Ajoutez <code>APACHE_MODPATH_INIT(nouveau_module)</code>.</li>
- <li>Copiez la ligne APACHE_MODULE contenant "example" depuis
- <code>modules/experimental/config.m4</code>.</li>
- <li>Remplacez le premier argument "example" par
+ <li>Copiez la ligne APACHE_MODULE contenant "example_hooks" depuis
+ <code>modules/examples/config.m4</code>.</li>
+ <li>Remplacez le premier argument "example-hooks" par
<em>monexemple</em>.</li>
- <li>Remplacez le second argument par une brève description de
- votre module. Cette description sera utilisée par la commande
+ <li>Remplacez le second argument par une brève description de
+ votre module. Cette description sera utilisée par la commande
<code>configure --help</code>.</li>
- <li>Si la compilation de votre module nécessite des drapeaux
- de compilation C, des drapeaux d'édition de liens, ou de
- bibliothèques supplémentaires, ajoutez les respectivement à
+ <li>Si la compilation de votre module nécessite des drapeaux
+ de compilation C, des drapeaux d'édition de liens, ou de
+ bibliothèques supplémentaires, ajoutez les respectivement à
CFLAGS, LDFLAGS et LIBS. Reportez-vous aux fichiers
- <code>config.m4</code> des répertoires des autres modules pour
+ <code>config.m4</code> des répertoires des autres modules pour
plus d'exemples.</li>
<li>Ajoutez <code>APACHE_MODPATH_FINISH</code>.</li>
</ol>
</li>
- <li>Créez le fichier
+ <li>Créez le fichier
<code>module/nouveau_module/Makefile.in</code>.
- Si la compilation de votre module ne nécessite pas d'instructions
- particulières, ce fichier ne doit contenir que la ligne
+ Si la compilation de votre module ne nécessite pas d'instructions
+ particulières, ce fichier ne doit contenir que la ligne
<code>include $(top_srcdir)/build/special.mk</code>.</li>
- <li>Exécutez ./buildconf à la racine du répertoire.</li>
+ <li>Exécutez ./buildconf à la racine du répertoire.</li>
- <li>Compilez le serveur après avoir exécuté la commande configure
+ <li>Compilez le serveur après avoir exécuté la commande configure
avec l'option --enable-monexemple.</li>
</ol>
</section>
<section id="using"><title>Utilisation du module
-<code>mod_example</code></title>
+<code>mod_example_hooks</code></title>
- <p>Pour activer le module example, ajoutez à votre fichier
+ <p>Pour activer le module example_hooks, ajoutez à votre fichier
<code>httpd.conf</code> un bloc du style :</p>
<highlight language="config">
-<Location /example-info>
- SetHandler example-handler
+<Location "/example-hooks-info">
+ SetHandler example-hooks-handler
</Location>
</highlight>
<p>Vous pouvez aussi ajouter ce qui suit dans un fichier <a
href="core.html#accessfilename"><code>.htaccess</code></a>, puis
- accéder au fichier "test.example" à partir du répertoire
+ accéder au fichier "test.example" à partir du répertoire
correspondant :</p>
<highlight language="config">
- AddHandler example-handler .example
+ AddHandler example-hooks-handler .example
</highlight>
- <p>Après avoir rechargé la configuration ou redémarré votre serveur,
- vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui
- a été décrit plus haut.</p>
+ <p>Après avoir rechargé la configuration ou redémarré votre serveur,
+ vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui
+ a été décrit plus haut.</p>
</section>
<directivesynopsis>
<name>Example</name>
-<description>Directive de démonstration pour illustrer l'API des modules
+<description>Directive de démonstration pour illustrer l'API des modules
Apache</description>
<syntax>Example</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
+<override>Options</override>
<usage>
<p>La directive <directive>Example</directive> n'a pour fonction que
- de définir un drapeau de démonstration que le gestionnaire de
- contenu du module example va afficher. Elle ne possède aucun
- argument. Si vous naviguez vers une URL à laquelle le gestionnaire
- de contenu example s'applique, vous verrez s'afficher les routines
- du module, ainsi que l'ordre dans lequel elles ont été appelées pour
- servir le document demandé. On peut observer l'effet de cette
+ de définir un drapeau de démonstration que le gestionnaire de
+ contenu du module example_hooks va afficher. Elle ne possède aucun
+ argument. Si vous naviguez vers une URL à laquelle le gestionnaire
+ de contenu example_hooks s'applique, vous verrez s'afficher les routines
+ du module, ainsi que l'ordre dans lequel elles ont été appelées pour
+ servir le document demandé. On peut observer l'effet de cette
directive dans la phrase "<code>Example
directive declared here: YES/NO</code>".</p>
</usage>