granicus.if.org Git - apache/blob - docs/manual/mod/mod_example_hooks.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: 1673892:1793934 (outdated) -->
   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_example_hooks.xml.meta">
  26
  27 <name>mod_example_hooks</name>
  28 <description>Illustration de l'API des modules Apache</description>
  29 <status>Experimental</status>
  30 <sourcefile>mod_example_hooks.c</sourcefile>
  31 <identifier>example_hooks_module</identifier>
  32
  33 <summary>
  34     <p>Certains fichiers situ&eacute;s dans le r&eacute;pertoire
  35     <code>modules/examples</code> de l'arborescence de la
  36     distribution d'Apache sont fournis &agrave; titre d'exemples pour ceux qui
  37     souhaitent &eacute;crire des modules qui utilisent l'API d'Apache.</p>
  38
  39     <p>Le fichier principal est <code>mod_example_hooks.c</code>, qui
  40     constitue une illustration exhaustive des diff&eacute;rents m&eacute;canismes et
  41     syntaxes d'appels. En aucun cas un module additionnel n'aura &agrave;
  42     inclure des routines pour tous les appels - il n'en n&eacute;cessitera au
  43     contraire qu'un petit nombre !</p>
  44
  45     <p>Le module example_hooks fonctionne r&eacute;ellement. Si vous le chargez dans
  46     votre serveur, activez le gestionnaire "example-hooks-handler" dans une
  47     section location, et essayez d'acc&eacute;der &agrave; la zone du site web
  48     correspondante, vous verrez s'afficher certaines sorties que le
  49     module example_hooks produit au cours des diff&eacute;rents appels.</p>
  50 </summary>
  51
  52 <section id="compiling"><title>Compilation du module example_hooks</title>
  53
  54     <p>Pour inclure le module example_hooks dans votre serveur, effectuez les
  55     &eacute;tapes suivantes :</p>
  56
  57     <ol>
  58       <li>Ex&eacute;cutez <program>configure</program> avec l'option
  59       <code>--enable-example-hooks</code>.</li>
  60
  61       <li>Compilez le serveur (ex&eacute;cutez la commande
  62       "<code>make</code>").</li>
  63     </ol>
  64
  65     <p>Pour ajouter votre propre module :</p>
  66
  67     <ol type="A">
  68       <li><code>cp modules/examples/mod_example_hooks.c
  69       modules/nouveau_module/<em>mod_monexemple.c</em></code></li>
  70
  71       <li>Modifiez le fichier.</li>
  72
  73       <li>Cr&eacute;ez <code>modules/nouveau_module/config.m4</code>.
  74         <ol>
  75           <li>Ajoutez <code>APACHE_MODPATH_INIT(nouveau_module)</code>.</li>
  76           <li>Copiez la ligne APACHE_MODULE contenant "example_hooks" depuis
  77           <code>modules/examples/config.m4</code>.</li>
  78           <li>Remplacez le premier argument "example-hooks" par
  79           <em>monexemple</em>.</li>
  80           <li>Remplacez le second argument par une br&egrave;ve description de
  81           votre module. Cette description sera utilis&eacute;e par la commande
  82           <code>configure --help</code>.</li>
  83           <li>Si la compilation de votre module n&eacute;cessite des drapeaux
  84           de compilation C, des drapeaux d'&eacute;dition de liens, ou de
  85           biblioth&egrave;ques suppl&eacute;mentaires, ajoutez les respectivement &agrave;
  86           CFLAGS, LDFLAGS et LIBS. Reportez-vous aux fichiers
  87           <code>config.m4</code> des r&eacute;pertoires des autres modules pour
  88           plus d'exemples.</li>
  89           <li>Ajoutez <code>APACHE_MODPATH_FINISH</code>.</li>
  90         </ol>
  91       </li>
  92
  93       <li>Cr&eacute;ez le fichier
  94       <code>module/nouveau_module/Makefile.in</code>.
  95       Si la compilation de votre module ne n&eacute;cessite pas d'instructions
  96       particuli&egrave;res, ce fichier ne doit contenir que la ligne
  97       <code>include $(top_srcdir)/build/special.mk</code>.</li>
  98
  99       <li>Ex&eacute;cutez ./buildconf &agrave; la racine du r&eacute;pertoire.</li>
 100
 101       <li>Compilez le serveur apr&egrave;s avoir ex&eacute;cut&eacute; la commande configure
 102       avec l'option --enable-monexemple.</li>
 103
 104     </ol>
 105 </section>
 106
 107 <section id="using"><title>Utilisation du module
 108 <code>mod_example_hooks</code></title>
 109
 110     <p>Pour activer le module example_hooks, ajoutez &agrave; votre fichier
 111     <code>httpd.conf</code> un bloc du style :</p>
 112 <highlight language="config">
 113 &lt;Location "/example-hooks-info"&gt;
 114    SetHandler example-hooks-handler
 115 &lt;/Location&gt;
 116 </highlight>
 117
 118     <p>Vous pouvez aussi ajouter ce qui suit dans un fichier <a
 119     href="core.html#accessfilename"><code>.htaccess</code></a>, puis
 120     acc&eacute;der au fichier "test.example" &agrave; partir du r&eacute;pertoire
 121     correspondant :</p>
 122
 123 <highlight language="config">
 124    AddHandler example-hooks-handler .example
 125    </highlight>
 126
 127
 128     <p>Apr&egrave;s avoir recharg&eacute; la configuration ou red&eacute;marr&eacute; votre serveur,
 129     vous devriez pouvoir acc&eacute;der &agrave; ce fichier et voir s'afficher ce qui
 130     a &eacute;t&eacute; d&eacute;crit plus haut.</p>
 131 </section>
 132
 133 <directivesynopsis>
 134 <name>Example</name>
 135 <description>Directive de d&eacute;monstration pour illustrer l'API des modules
 136 Apache</description>
 137 <syntax>Example</syntax>
 138 <contextlist><context>server config</context>
 139 <context>virtual host</context><context>directory</context>
 140 <context>.htaccess</context></contextlist>
 141
 142 <usage>
 143     <p>La directive <directive>Example</directive> n'a pour fonction que
 144     de d&eacute;finir un drapeau de d&eacute;monstration que le gestionnaire de
 145     contenu du module example_hooks va afficher. Elle ne poss&egrave;de aucun
 146     argument. Si vous naviguez vers une URL &agrave; laquelle le gestionnaire
 147     de contenu example_hooks s'applique, vous verrez s'afficher les routines
 148     du module, ainsi que l'ordre dans lequel elles ont &eacute;t&eacute; appel&eacute;es pour
 149     servir le document demand&eacute;. On peut observer l'effet de cette
 150     directive dans la phrase "<code>Example
 151     directive declared here: YES/NO</code>".</p>
 152 </usage>
 153 </directivesynopsis>
 154
 155 </modulesynopsis>