apache/docs/manual/howto/ssi.xml.fr

   1 <?xml version="1.0" encoding="ISO-8859-1" ?>
   2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 659902 -->
   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 <manualpage metafile="ssi.xml.meta">
  26 <parentdocument href="./">Recettes et tutoriels</parentdocument>
  27
  28 <title>Tutoriel Apache : Introduction aux "Inclusions C&ocirc;t&eacute; Serveur"
  29 (Server Side Includes - SSI)</title>
  30
  31 <summary>
  32 <p>Les SSI permettent d'ajouter du contenu dynamique &agrave; des documents
  33 HTML pr&eacute;existants.</p>
  34 </summary>
  35
  36 <section id="related"><title>Introduction</title>
  37  <related>
  38     <modulelist>
  39     <module>mod_include</module>
  40     <module>mod_cgi</module>
  41     <module>mod_expires</module>
  42     </modulelist>
  43
  44     <directivelist>
  45     <directive module="core">Options</directive>
  46     <directive module="mod_include">XBitHack</directive>
  47     <directive module="mod_mime">AddType</directive>
  48     <directive module="core">SetOutputFilter</directive>
  49     <directive module="mod_setenvif">BrowserMatchNoCase</directive>
  50     </directivelist>
  51 </related>
  52
  53     <p>Cet article traite des Inclusions C&ocirc;t&eacute; Serveur (Server Side
  54     Includes), plus commun&eacute;ment appel&eacute;s SSI. Vous trouverez ici la
  55     mani&egrave;re de configurer votre serveur pour permettre les SSI, ainsi
  56     qu'une introduction &agrave; quelques techniques SSI de base permettant
  57     d'ajouter du contenu dynamique &agrave; vos pages HTML pr&eacute;existantes.</p>
  58
  59     <p>La derni&egrave;re partie de cet article sera consacr&eacute;e aux
  60     configurations SSI plus avanc&eacute;es, telles que les expressions
  61     conditionnelles dans les directives SSI.</p>
  62
  63 </section>
  64
  65 <section id="what"><title>Qu'est-ce que SSI ?</title>
  66
  67     <p>SSI (Server Side Includes) est constitu&eacute; de directives plac&eacute;es dans
  68     des pages HTML, et &eacute;valu&eacute;es par le serveur au moment o&ugrave; les pages
  69     sont servies. Elles vous permettent d'ajouter du contenu g&eacute;n&eacute;r&eacute;
  70     dynamiquement &agrave; une page HTML pr&eacute;existante, sans avoir &agrave; servir la
  71     page enti&egrave;re via un programme CGI, ou toute autre technologie de
  72     contenu dynamique.</p>
  73
  74     <p>Le choix entre l'utilisation des SSI et la g&eacute;n&eacute;ration enti&egrave;re de
  75     la page par un programme quelconque, est en g&eacute;n&eacute;ral dict&eacute; par la
  76     proportion de contenu statique et de contenu devant &ecirc;tre g&eacute;n&eacute;r&eacute;
  77     chaque fois que la page est servie. SSI est id&eacute;al pour ajouter de
  78     petites quantit&eacute;s d'information, comme l'heure courante. Mais si la
  79     plus grande partie de votre page est g&eacute;n&eacute;r&eacute;e au moment o&ugrave; elle est
  80     servie, vous devez vous tourner vers une autre solution.</p>
  81 </section>
  82
  83 <section id="configuring">
  84 <title>Configurer votre serveur pour permettre les SSI</title>
  85
  86     <p>Pour permettre l'utilisation des SSI sur votre serveur, vous
  87     devez ajouter la directive suivante dans votre fichier
  88     <code>httpd.conf</code>, ou dans un fichier <code>.htaccess</code>
  89     :</p>
  90 <example>
  91         Options +Includes
  92 </example>
  93
  94     <p>Cette directive indique &agrave; Apache que vous d&eacute;sirez permettre la
  95     recherche de directives SSI lors de l'interpr&eacute;tation des fichiers.
  96     Notez cependant que la plupart des configurations contiennent de
  97     nombreuses directives <directive module="core">Options</directive>
  98     qui peuvent s'&eacute;craser les unes les autres. Vous devrez probablement
  99     appliquer ces directives <code>Options</code> au r&eacute;pertoire
 100     sp&eacute;cifique pour lequel vous voulez activer les SSI, afin d'&ecirc;tre s&ucirc;r
 101     qu'elles y seront bien activ&eacute;es.</p>
 102
 103     <p>Tout fichier ne fera cependant pas l'objet de recherche de
 104     directives SSI. Vous devez indiquer &agrave; Apache quels fichiers seront
 105     concern&eacute;s. Vous pouvez y parvenir en indiquant une extension, comme
 106     <code>.shtml</code>, &agrave; l'aide des directives suivantes :</p>
 107 <example>
 108         AddType text/html .shtml<br />
 109         AddOutputFilter INCLUDES .shtml
 110 </example>
 111
 112     <p>Un des d&eacute;savantages de cette approche r&eacute;side dans le fait que si
 113     vous voulez ajouter des directives SSI &agrave; une page pr&eacute;existante, vous
 114     devrez changer le nom de cette page, et donc tout lien qui la
 115     contient, de fa&ccedil;on &agrave; ce qu'elle poss&egrave;de l'extension
 116     <code>.shtml</code>, condition n&eacute;cessaire pour que les directives
 117     SSI qu'elle contient soient trait&eacute;es.</p>
 118
 119     <p>Une autre m&eacute;thode consiste &agrave; utiliser la directive <directive
 120     module="mod_include">XBitHack</directive> :</p>
 121 <example>
 122         XBitHack on
 123 </example>
 124
 125     <p>La directive <directive module="mod_include">XBitHack</directive>
 126     indique &agrave; Apache qu'il doit rechercher des directivves SSI dans les
 127     fichiers si leur bit d'ex&eacute;cution est positionn&eacute;. Il n'est ainsi plus
 128     n&eacute;cessaire de changer le nom du fichier pour ajouter des directives
 129     SSI &agrave; une page pr&eacute;existante ; vous devez simplement attribuer les
 130     droits d'ex&eacute;cution au fichier &agrave; l'aide de <code>chmod</code>.</p>
 131 <example>
 132         chmod +x pagename.html
 133 </example>
 134
 135     <p>Un bref commentaire sur ce qu'il ne faut pas faire. Certaines
 136     personnes peuvent vous conseiller de tout simplement indiquer &agrave;
 137     Apache de rechercher des directives SSI dans tous les fichiers
 138     <code>.html</code>, ce qui vous &eacute;vite d'avoir &agrave; g&eacute;rer les noms de
 139     fichiers avec extension <code>.shtml</code>. Ils n'ont probablement
 140     pas entendu parler de la directive <directive
 141     module="mod_include">XBitHack</directive>. En effet, vous devez
 142     garder &agrave; l'esprit qu'en faisant ceci, Apache va devoir rechercher
 143     des directives SSI dans chaque fichier qu'il sert, m&ecirc;me s'il n'en
 144     contient aucune. Ce n'est donc pas une bonne id&eacute;e car les
 145     performances peuvent en &ecirc;tre sensiblement affect&eacute;es.</p>
 146
 147     <p>Bien entendu, sous Windows, il n'y a pas de bit d'ex&eacute;cution &agrave;
 148     positionner, ce qui limite un peu vos choix.</p>
 149
 150     <p>Dans sa configuration par d&eacute;faut, Apache n'envoie pas la date de
 151     derni&egrave;re modification ou les en-t&ecirc;tes HTTP relatifs &agrave; la taille des
 152     contenus dans les pages SSI, car ses valeurs sont difficiles &agrave;
 153     calculer pour les contenus dynamiques. Ceci peut induire une
 154     impression de diminution des performances c&ocirc;t&eacute; client, en emp&ecirc;chant
 155     la mise en cache de votre document. Il existe deux m&eacute;thodes pour
 156     r&eacute;soudre ce probl&egrave;me :</p>
 157
 158     <ol>
 159       <li>Utilisez la configuration <code>XBitHack Full</code>. Elle
 160       indique &agrave; Apache de d&eacute;terminer la date de derni&egrave;re modification en
 161       ne regardant que la date du fichier &agrave; l'origine de la requ&ecirc;te,
 162       tout en ignorant la date de modification de tout fichier inclus.</li>
 163
 164       <li>Utilisez les directives fournies par le module
 165       <module>mod_expires</module> pour d&eacute;finir de mani&egrave;re explicite la
 166       date d'expiration de vos fichiers, laissant par la-m&ecirc;me
 167       aux navigateurs et aux mandataires le soin de d&eacute;terminer s'il est
 168       opportun ou non de les mettre en cache.</li>
 169     </ol>
 170 </section>
 171
 172 <section id="basic"><title>Directives SSI de base</title>
 173
 174     <p>Les directives SSI adoptent la syntaxe suivante :</p>
 175 <example>
 176         &lt;!--#&eacute;l&eacute;ment attribut=valeur attribut=valeur ... --&gt;
 177 </example>
 178
 179     <p>Le format d'une directive SSI &eacute;tant similaire &agrave; celui d'un
 180     commentaire HTML, si vous n'avez pas activ&eacute; correctement SSI, le
 181     navigateur l'ignorera, mais elle sera encore visible dans le source
 182     HTML. Si SSI est correctement configur&eacute;, la directive sera remplac&eacute;e
 183     par ses r&eacute;sultats.</p>
 184
 185     <p>"&eacute;l&eacute;ment" peut prendre de nombreuses formes, et nous d&eacute;crirons
 186     plus pr&eacute;cis&eacute;ment la plupart d'entre eux dans la prochaine version de
 187     ce document. Pour le moment, voici quelques exemples de ce que vous
 188     pouvez faire avec SSI.</p>
 189
 190 <section id="todaysdate"><title>La date courante</title>
 191
 192 <example>
 193         &lt;!--#echo var="DATE_LOCAL" --&gt;
 194 </example>
 195
 196     <p>L'&eacute;l&eacute;ment <code>echo</code> permet d'afficher la valeur d'une
 197     variable. Il existe un grand nombre de variables standards, y
 198     compris l'ensemble des variables d'environnement disponibles pour
 199     les programmes CGI. De plus, vous pouvez d&eacute;finir vos propres
 200     variables &agrave; l'aide de l'&eacute;l&eacute;ment <code>set</code>.</p>
 201
 202     <p>Si vous n'aimez pas le format sous lequel la date s'affiche, vous
 203     pouvez utiliser l'&eacute;l&eacute;ment <code>config</code> avec un attribut
 204     <code>timefmt</code>, pour le modifier.</p>
 205
 206 <example>
 207         &lt;!--#config timefmt="%A %B %d, %Y" --&gt;<br />
 208         Today is &lt;!--#echo var="DATE_LOCAL" --&gt;
 209 </example>
 210 </section>
 211
 212 <section id="lastmodified"><title>Date de modification du fichier</title>
 213
 214 <example>
 215         Derni&egrave;re modification du document &lt;!--#flastmod file="index.html" --&gt;
 216 </example>
 217
 218     <p>Le format peut l&agrave; aussi &ecirc;tre modifi&eacute; &agrave; l'aide de l'attribut
 219     <code>timefmt</code>.</p>
 220 </section>
 221
 222 <section id="cgi"><title>Inclusion des r&eacute;sultats d'un programme CGI</title>
 223
 224     <p>C'est le cas le plus courant d'utilisation des SSI - afficher les
 225     r&eacute;sultats d'un programme CGI, comme l'universellement ador&eacute;
 226     "compteur d'acc&egrave;s".</p>
 227
 228 <example>
 229         &lt;!--#include virtual="/cgi-bin/counter.pl" --&gt;
 230 </example>
 231
 232 </section>
 233 </section>
 234
 235 <section id="additionalexamples">
 236 <title>Exemples additionnels</title>
 237
 238     <p>Vous trouverez dans ce qui suit quelques exemples sp&eacute;cifiques de
 239     ce que vous pouvez faire de vos documents HTML avec SSI.</p>
 240
 241 <section id="docmodified"><title>Quand ce document a-t-il &eacute;t&eacute; modifi&eacute; ?</title>
 242
 243     <p>Nous avons mentionn&eacute; plus haut que vous pouviez utiliser SSI pour
 244     informer l'utilisateur de la date de derni&egrave;re modification du
 245     document. Cependant, la m&eacute;thode pour y parvenir n'a pas &eacute;t&eacute; vraiment
 246     abord&eacute;e. Plac&eacute; dans votre document HTML, le code suivant va ins&eacute;rer
 247     un rep&egrave;re de temps dans votre page. Bien entendu, SSI devra avoir
 248     &eacute;t&eacute; correctement activ&eacute;, comme d&eacute;crit plus haut.</p>
 249 <example>
 250         &lt;!--#config timefmt="%A %B %d, %Y" --&gt;<br />
 251         Derni&egrave;re modification du fichier &lt;!--#flastmod file="ssi.shtml" --&gt;
 252 </example>
 253
 254     <p>Bien entendu, vous devez remplacer <code>ssi.shtml</code> par le
 255     nom du fichier auquel vous faites r&eacute;f&eacute;rence. Ceci ne conviendra pas
 256     si vous recherchez un morceau de code g&eacute;n&eacute;rique que vous pourrez
 257     ins&eacute;rer dans tout fichier ; dans ce cas, il est pr&eacute;f&eacute;rable
 258     d'utiliser la variable <code>LAST_MODIFIED</code> :</p>
 259 <example>
 260         &lt;!--#config timefmt="%D" --&gt;<br />
 261         This file last modified &lt;!--#echo var="LAST_MODIFIED" --&gt;
 262 </example>
 263
 264     <p>Pour plus de d&eacute;tails sur le format <code>timefmt</code>, tapez
 265     <code>strftime</code> dans votre moteur de recherche pr&eacute;fer&eacute;. La
 266     syntaxe est identique.</p>
 267 </section>
 268
 269 <section id="standard-footer">
 270 <title>Inclusion d'un pied de page standard</title>
 271
 272     <p>Si le site que vous g&eacute;rez comporte plus que quelques pages, vous
 273     allez vite vous apercevoir qu'effectuer des modifications sur toutes
 274     ces pages peut devenir tr&egrave;s contraignant, en particulier si vous
 275     voulez qu'elles conservent un aspect homog&egrave;ne.</p>
 276
 277     <p>Inclure un fichier pour un en-t&ecirc;te et/ou un pied de page peut
 278     simplifier cette corv&eacute;e de mises &agrave; jour. Il vous suffit de
 279     confectionner un fichier de pied de page, et de l'inclure dans
 280     chaque page &agrave; l'aide de l'&eacute;l&eacute;ment SSI <code>include</code>. Pour
 281     d&eacute;finir le fichier &agrave; inclure, l'&eacute;l&eacute;ment <code>include</code> peut
 282     utiliser soit l'attribut <code>file</code>, soit l'attribut
 283     <code>virtual</code>. L'attribut <code>file</code> est un chemin de
 284     fichier <em>relatif au r&eacute;pertoire courant</em>. C'est &agrave; dire qu'il
 285     ne peut ni avoir pour valeur un chemin absolu (commen&ccedil;ant par /), ni
 286     comporter "../" dans son chemin. L'attribut <code>virtual</code> est
 287     probablement plus commode, et peut sp&eacute;cifier une URL relative au
 288     document servi. Elle peut commencer par un /, mais le fichier inclus
 289     et le fichier servi doivent r&eacute;sider sur le m&ecirc;me serveur.</p>
 290 <example>
 291         &lt;!--#include virtual="/footer.html" --&gt;
 292 </example>
 293
 294     <p>Je combinerai souvent ces deux derniers points, en ajoutant une
 295     directive <code>LAST_MODIFIED</code> dans un fichier de pied de page
 296     destin&eacute; &agrave; &ecirc;tre inclus. Le fichier inclus peut contenir des
 297     directives SSI, et les inclusions peuvent &ecirc;tre imbriqu&eacute;es - &agrave;
 298     savoir, le fichier inclus peut inclure un autre fichier, etc...</p>
 299 </section>
 300
 301 </section>
 302
 303 <section id="config">
 304 <title>Que puis-je configurer d'autre ?</title>
 305
 306     <p>En plus du format de date, vous pouvez utiliser l'&eacute;l&eacute;ment
 307     <code>config</code> pour configurer deux autres choses.</p>
 308
 309     <p>En g&eacute;n&eacute;ral, lorsque quelque chose se passe mal avec votre
 310     directive SSI, vous recevez le message :</p>
 311 <example>
 312         [an error occurred while processing this directive]
 313 </example>
 314
 315     <p>Pour modifier ce message, vous pouvez utiliser l'attribut
 316     <code>errmsg</code> avec l'&eacute;l&eacute;ment <code>config</code> :</p>
 317 <example>
 318         &lt;!--#config errmsg="[Il semblerait que vous ne sachiez pas
 319         utiliser les SSI]" --&gt;
 320 </example>
 321
 322     <p>Il est cependant probable que les utilisateurs finaux ne voient
 323     jamais ce message, car vous aurez r&eacute;solu tous les probl&egrave;mes issus de
 324     vos directives SSI avant que votre site ne soit mis en production.
 325     (N'est-ce pas ?)</p>
 326
 327     <p>Vous pouvez aussi modifier le format sous lequel les tailles de
 328     fichiers sont affich&eacute;es &agrave; l'aide de l'attribut <code>sizefmt</code>.
 329     Vous pouvez sp&eacute;cifier <code>bytes</code> pour un affichage en
 330     octets, ou <code>abbrev</code> pour un affichage plus concis en Ko
 331     ou Mo, selon le cas.</p>
 332     </section>
 333
 334 <section id="exec">
 335     <title>Ex&eacute;cution de commandes</title>
 336
 337     <p>J'ai pour projet, dans les prochains mois, d'&eacute;crire un article &agrave;
 338     propos de l'utilisation des SSI avec des petits programmes CGI. Pour
 339     l'instant, voici ce que vous pouvez faire avec l'&eacute;l&eacute;ment
 340     <code>exec</code>. Vous pouvez vraiment faire ex&eacute;cuter une commande
 341     par SSI en utilisant le shell (<code>/bin/sh</code>, pour &ecirc;tre plus
 342     pr&eacute;cis - ou le shell DOS, si vous &ecirc;tes sous Win32). Par exemple, ce
 343     qui suit vous permet d'afficher le contenu d'un r&eacute;pertoire.</p>
 344 <example>
 345         &lt;pre&gt;<br />
 346         &lt;!--#exec cmd="ls" --&gt;<br />
 347         &lt;/pre&gt;
 348 </example>
 349
 350     <p>ou, sous Windows</p>
 351 <example>
 352         &lt;pre&gt;<br />
 353         &lt;!--#exec cmd="dir" --&gt;<br />
 354         &lt;/pre&gt;
 355 </example>
 356
 357     <p>Vous noterez probablement l'&eacute;trange formatage provoqu&eacute; par cette
 358     directive sous Windows, car la sortie de <code>dir</code> contient
 359     la cha&icirc;ne  de caract&egrave;res "&lt;<code>dir</code>&gt;", ce qui trompe le
 360     navigateur.</p>
 361
 362     <p>Notez que cette fonctionnalit&eacute; est tr&egrave;s dangereuse, car elle va
 363     permettre d'ex&eacute;cuter tout code associ&eacute; &agrave; l'&eacute;l&eacute;ment
 364     <code>exec</code>. Si vous &ecirc;tes dans la situation o&ugrave; les
 365     utilisateurs peuvent &eacute;diter le contenu de vos pages web, dans le cas
 366     d'un "livre d'or" par exemple, assurez-vous de d&eacute;sactiver cette
 367     fonctionnalit&eacute;. Vous pouvez, tout en permettant les SSI, d&eacute;sactiver
 368     la fonctionnalit&eacute; <code>exec</code> &agrave; l'aide de l'argument
 369     <code>IncludesNOEXEC</code> de la directive
 370     <code>Options</code>.</p>
 371     </section>
 372
 373 <section id="advanced">
 374 <title>Techniques SSI avanc&eacute;es</title>
 375
 376     <p>Outre l'affichage de contenu, les SSI d'Apache vous permettent de
 377     d&eacute;finir des variables, et de les utiliser dans des comparaisons et
 378     des conditions.</p>
 379
 380 <section id="caveat"><title>Mise en garde</title>
 381
 382     <p>La plupart des fonctionnalit&eacute;s d&eacute;crites dans cet article ne sont
 383     disponibles que si vous utilisez la version 1.2 ou sup&eacute;rieure
 384     d'Apache. Bien entendu, si ce n'est pas le cas, vous devez faire une
 385     mise &agrave; jour imm&eacute;diatement, et m&ecirc;me plus t&ocirc;t. Allez-y. Faites-le
 386     maintenant. Nous attendrons.</p>
 387 </section>
 388
 389 <section id="variables"><title>D&eacute;finition de variables</title>
 390
 391     <p>Avec l'&eacute;l&eacute;ment <code>set</code>, vous pouvez d&eacute;finir des
 392     variables pour un usage ult&eacute;rieur. Comme nous en aurons besoin plus
 393     loin, nous allons en parler tout de suite. La syntaxe se pr&eacute;sente
 394     comme suit :</p>
 395 <example>
 396         &lt;!--#set var="name" value="Rich" --&gt;
 397 </example>
 398
 399     <p>Pour affecter une valeur &agrave; vos variables, en plus de la
 400     d&eacute;finition litt&eacute;rale de l'exemple ci-dessus, vous pouvez utiliser
 401     une autre variable, y compris les <a
 402     href="../env.html">variables d'environnement</a>, ou les variables
 403     d&eacute;crites plus haut (comme <code>LAST_MODIFIED</code> par exemple).
 404     Pour indiquer qu'il s'agit d'une variable et non d'une cha&icirc;ne, vous
 405     devez utiliser le symbole dollar ($) devant le nom de la
 406     variable.</p>
 407
 408     <example> &lt;!--#set var="modified" value="$LAST_MODIFIED" --&gt;
 409     </example>
 410
 411     <p>Pour ins&eacute;rer un caract&egrave;re $ dans la valeur de votre variable,
 412     vous devez l'&eacute;chapper &agrave; l'aide d'un backslash.</p>
 413 <example>
 414         &lt;!--#set var="cost" value="\$100" --&gt;
 415 </example>
 416
 417     <p>Enfin, si vous voulez ins&eacute;rer une variable dans une cha&icirc;ne, et
 418     s'il y a une chance pour que le nom de la variable se confonde avec
 419     le reste de la cha&icirc;ne, vous pouvez l'entourer d'accolades pour
 420     eviter toute confusion (Il est difficile de trouver un bon exemple
 421     pour illustrer ceci, mais j'esp&egrave;re que vous comprendrez).</p>
 422 <example>
 423         &lt;!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" --&gt;
 424 </example>
 425 </section>
 426
 427 <section id="conditional">
 428 <title>Expressions conditionnelles</title>
 429
 430     <p>Maintenent que nous avons des variables, et que nous pouvons
 431     d&eacute;finir et comparer leurs valeurs, nous sommes &agrave; m&ecirc;me de les
 432     utiliser dans des expressions conditionnelles. Ceci conf&egrave;re &agrave; SSI le
 433     statut de petit langage de programmation.
 434     <module>mod_include</module> fournit une structure <code>if</code>,
 435     <code>elif</code>, <code>else</code>, <code>endif</code> pour la
 436     construction d'expressions conditionnelles, ce qui vous permet de
 437     g&eacute;n&eacute;rer plusieurs pages logiques &agrave; partir d'une seule vraie
 438     page.</p>
 439
 440     <p>La structure de l'expression conditionnelle est :</p>
 441 <example>
 442     &lt;!--#if expr="condition" --&gt;<br />
 443     &lt;!--#elif expr="condition" --&gt;<br />
 444     &lt;!--#else --&gt;<br />
 445     &lt;!--#endif --&gt;
 446 </example>
 447
 448     <p>Une <em>condition</em> peut rev&ecirc;tir la forme de toute comparaison
 449     logique - soit une comparaison de valeurs avec une autre, soit une
 450     v&eacute;rification de la "v&eacute;rit&eacute;" d'une valeur particuli&egrave;re (Une cha&icirc;ne
 451     donn&eacute;e est vraie si elle n'est pas vide). Pour une liste exhaustive
 452     des op&eacute;rateurs de comparaison disponibles, voir la documentation du
 453     module <module>mod_include</module>. Voici quelques exemples
 454     illustrant l'utilisation de ces expressions.</p>
 455
 456     <p>Vous pouvez ajouter les lignes suivantes dans votre fichier de
 457     configuration :</p>
 458 <example>
 459         BrowserMatchNoCase macintosh Mac<br />
 460         BrowserMatchNoCase MSIE InternetExplorer
 461 </example>
 462
 463     <p>Ces lignes d&eacute;finissent les variables d'environnement "Mac" et
 464     "InternetExplorer" &agrave; true, si le client utilise InternetExplorer sur
 465     un Macintosh.</p>
 466
 467     <p>Puis, dans votre document o&ugrave; les SSI sont activ&eacute;es, vous ajoutez
 468     ceci :</p>
 469 <example>
 470         &lt;!--#if expr="${Mac} &amp;&amp; ${InternetExplorer}" --&gt;<br />
 471         Un texte d'excuses est ins&eacute;r&eacute; ici<br />
 472         &lt;!--#else --&gt;<br />
 473         Ici se trouve du code JavaScipt sympa<br />
 474         &lt;!--#endif --&gt;
 475 </example>
 476
 477     <p>Notez que je n'ai rien contre IE sur Macintosh - J'ai juste
 478     phosphor&eacute; quelques heures la semaine derni&egrave;re pour faire fonctionner
 479     du JavaScript sous IE sur Macintosh, alors qu'il fonctionnait sous
 480     tout autre environnement. Ce qui pr&eacute;c&egrave;de a constitu&eacute; un
 481     contournement provisoire.</p>
 482
 483     <p>Toute autre variable (que vous avez d&eacute;finie, ou une variable
 484     d'environnement normale) peut &ecirc;tre utilis&eacute;e dans les expressions
 485     conditionnelles. Associ&eacute;e &agrave; la possibilit&eacute; avec Apache de d&eacute;finir
 486     des variables d'environnement &agrave; l'aide de directives
 487     <code>SetEnvIf</code>, ainsi que d'autres directives en rapport,
 488     cette fonctionnalit&eacute; vous permet d'ajouter des contenus dynamiques
 489     assez &eacute;volu&eacute;s sans avoir recours aux programmes CGI.</p>
 490 </section>
 491 </section>
 492
 493 <section id="conclusion"><title>Conclusion</title>
 494
 495     <p>SSI ne remplace certainement pas CGI, ou d'autres technologies
 496     utilis&eacute;es pour la g&eacute;n&eacute;ration de pages web dynamiques. Mais c'est une
 497     bonne m&eacute;thode pour ajouter des petits contenus dynamiques &agrave; vos
 498     pages, sans devoir fournir un gros effort suppl&eacute;mentaire.</p>
 499 </section>
 500
 501 </manualpage>