blob: 3eae877b38d42d95e75c9263ae6db40eacb21ed3 [file]
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_include - Serveur HTTP Apache Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.5</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_include</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_include.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_include.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_include.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div>
<div class="outofdate">Cette traduction peut &ecirc;tre p&eacute;rim&eacute;e. V&eacute;rifiez la version
anglaise pour les changements r&eacute;cents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Documents html interpr&eacute;t&eacute;s par le serveur (Server Side
Includes ou SSI)</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur&nbsp;de&nbsp;Module:</a></th><td>include_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier&nbsp;Source:</a></th><td>mod_include.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module fournit un filtre qui va traiter les fichiers avant
de les envoyer au client. Le traitement est contr&ocirc;l&eacute; via des
commentaires SGML sp&eacute;cialement format&eacute;s, aussi nomm&eacute;s
<dfn>&eacute;l&eacute;ments</dfn>. Ces &eacute;l&eacute;ments permettent l'insertion
conditionnelle de texte, l'inclusion d'autres fichiers ou
programmes, ainsi que la d&eacute;finition et l'affichage de variables
d'environnement.</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif"> <a href="#enabling">Activation des SSI</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#pathinfo">PATH_INFO et SSI</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#elements">El&eacute;ments disponibles</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#includevars">Variables include</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#substitution">Substitution de variable</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flowctrl">El&eacute;ments de contr&ocirc;le d'inclusion conditionnelle</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#legacyexpr">Syntaxe des expressions h&eacute;rit&eacute;e</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif"> <a href="#ssiendtag">SSIEndTag</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssierrormsg">SSIErrorMsg</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssietag">SSIETag</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssilastmodified">SSILastModified</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssilegacyexprparser">SSILegacyExprParser</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssistarttag">SSIStartTag</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssitimeformat">SSITimeFormat</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#ssiundefinedecho">SSIUndefinedEcho</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#xbithack">XBitHack</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_include">Probl&egrave;mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_include">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
<li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
<li><a href="../filter.html">Les filtres</a></li>
<li><a href="../howto/ssi.html">Tutoriel SSI</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="enabling">Activation des SSI <a title="Lien permanent" href="#enabling" class="permalink">&para;</a></h2>
<p>Les SSI sont impl&eacute;ment&eacute;s par le <a href="../filter.html">filtre</a> <code>INCLUDES</code>. Si des
documents contenant des directives SSI poss&egrave;dent une extension
.shtml, les directives suivantes indiqueront &agrave; Apache de les
interpr&eacute;ter et d'assigner le type MIME
<code>text/html</code> au document obtenu :</p>
<pre class="prettyprint lang-config">AddType text/html .shtml
AddOutputFilter INCLUDES .shtml</pre>
<p>L'option suivante doit &ecirc;tre d&eacute;finie pour les r&eacute;pertoires qui
contiennent les fichiers shtml (en g&eacute;n&eacute;ral dans une section
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, mais
cette option peut &eacute;galement &ecirc;tre d&eacute;finie dans un fichier
<code>.htaccess</code> si <code><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> Options</code> a &eacute;t&eacute; d&eacute;fini pour le
r&eacute;pertoire consid&eacute;r&eacute;) :</p>
<pre class="prettyprint lang-config">Options +Includes</pre>
<p>Pour des raisons de compatibilit&eacute; ascendante, le <a href="../handler.html">gestionnaire</a> <code>server-parsed</code>
peut aussi activer le filtre INCLUDES. Ainsi, Apache va activer le
filtre INCLUDES pour tout document de type MIME
<code>text/x-server-parsed-html</code> ou
<code>text/x-server-parsed-html3</code> (et le document obtenu aura
pour type MIME <code>text/html</code>).</p>
<p>Pour plus d'informations, voyez notre <a href="../howto/ssi.html">Tutoriel SSI</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="pathinfo">PATH_INFO et SSI <a title="Lien permanent" href="#pathinfo" class="permalink">&para;</a></h2>
<p>Les fichiers trait&eacute;s dans le cadre des SSI n'acceptent plus par d&eacute;faut
les requ&ecirc;tes avec <a class="glossarylink" href="../glossary.html#pathinfo" title="voir glossaire">PATH_INFO</a> (les
informations relatives au chemin en fin de requ&ecirc;te). La directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> permet de configurer le serveur de
fa&ccedil;on &agrave; ce qu'il accepte ce genre de requ&ecirc;te.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="elements">El&eacute;ments disponibles <a title="Lien permanent" href="#elements" class="permalink">&para;</a></h2>
<p>Le document est interpr&eacute;t&eacute; comme un document HTML, avec des
commandes sp&eacute;ciales incluses sous forme de commentaires SGML. La
syntaxe d'une commande est la suivante : </p>
<div class="example"><p><code>
&lt;!--#<var>&eacute;l&eacute;ment</var> <var>attribut</var>=<var>valeur</var>
<var>attribut</var>=<var>valeur</var> ... --&gt;
</code></p></div>
<p>Les valeurs sont souvent entour&eacute;es de guillemets, mais on peut
aussi utiliser des apostrophes (<code>'</code>) ou des apostrophes
inverses (<code>`</code>). De nombreuses commandes n'acceptent
qu'une seule paire attribut-valeur. Notez que le terminateur de
commentaire (<code>--&gt;</code>) doit &ecirc;tre pr&eacute;c&eacute;d&eacute; d'un espace afin
d'&ecirc;tre s&ucirc;r qu'il ne soit pas consid&eacute;r&eacute; comme un &eacute;l&eacute;ment de commande
SSI. Notez aussi que le d&eacute;limiteur de d&eacute;but <code>&lt;!--#</code>
est <em>un</em> &eacute;l&eacute;ment de commande et ne doit donc pas contenir
d'espace.</p>
<p>La table suivante contient la liste des &eacute;l&eacute;ments autoris&eacute;s :</p>
<table class="bordered">
<tr><th>El&eacute;ment</th><th>Description</th></tr>
<tr><td><code><a href="#element.comment">comment</a></code></td>
<td>commentaire SSI</td></tr>
<tr><td><code><a href="#element.config">config</a></code></td>
<td>configure les formats de sortie</td></tr>
<tr><td><code><a href="#element.echo">echo</a></code></td>
<td>affiche le contenu de variables</td></tr>
<tr><td><code><a href="#element.exec">exec</a></code></td>
<td>ex&eacute;cute des programmes externes</td></tr>
<tr><td><code><a href="#element.fsize">fsize</a></code></td>
<td>affiche la taille d'un fichier</td></tr>
<tr><td><code><a href="#element.flastmod">flastmod</a></code></td>
<td>affiche la date de derni&egrave;re modification d'un fichier</td></tr>
<tr><td><code><a href="#element.include">include</a></code></td>
<td>inclut un fichier</td></tr>
<tr><td><code><a href="#element.printenv">printenv</a></code></td>
<td>affiche toutes les variables disponibles</td></tr>
<tr><td><code><a href="#element.set">set</a></code></td>
<td>d&eacute;finit la valeur d'une variable</td></tr>
</table>
<p>Les &eacute;l&eacute;ments SSI peuvent &ecirc;tre d&eacute;finis par d'autres modules que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. &Agrave; ce titre, l'&eacute;l&eacute;ment <code><a href="#element.exec">exec</a></code> est fourni par
<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, et ne sera disponible que si ce module est
charg&eacute;.</p>
<h3 id="element.comment">L'&eacute;l&eacute;ment comment</h3>
<p>Cette commande n'affiche aucune information. Elle n'a pour but que
l'ajout de commentaires dans un fichier et ces commentaires ne sont pas
affich&eacute;s.</p>
<p>Cette syntaxe est disponible &agrave; partir de la version 2.4.21 du serveur
HTTP Apache.</p>
<div class="example"><p><code>
&lt;!--#comment Blah Blah Blah --&gt;<br>
&nbsp;&nbsp;&nbsp;or<br>
&lt;!--#comment text="Blah Blah Blah" --&gt;
</code></p></div>
<h3 id="element.config">L'&eacute;l&eacute;ment config</h3>
<p>Cette commande contr&ocirc;le divers aspects de l'interpr&eacute;tation. Les
attributs valides sont :</p>
<dl>
<dt><code>echomsg</code> (<em>Versions 2.1 et sup&eacute;rieures
d'Apache</em>)</dt>
<dd><p>La valeur est un message qui sera envoy&eacute; au client si
l'&eacute;l&eacute;ment <code><a href="#element.echo">echo</a></code> tente
d'afficher le contenu d'une variable non d&eacute;finie. Cet attribut
l'emporte sur toute directive <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code>.</p>
<div class="example"><p><code>
&lt;!--#config echomsg="[Valeur non d&eacute;finie]" --&gt;
</code></p></div>
</dd>
<dt><code>errmsg</code></dt>
<dd><p>La valeur est un message qui sera envoy&eacute; au client si une
erreur survient lors de l'interpr&eacute;tation du document. Cet attribut
l'emporte sur toute directive <code class="directive"><a href="#ssierrormsg">SSIErrorMsg</a></code>.</p>
<div class="example"><p><code>
&lt;!--#config errmsg="[Zut, quelque chose s'est mal pass&eacute;.]" --&gt;
</code></p></div>
</dd>
<dt><code>sizefmt</code></dt>
<dd><p>La valeur d&eacute;finit l'unit&eacute; employ&eacute;e lors de l'affichage de la
taille d'un fichier. Les valeurs possibles sont <code>bytes</code>
pour une taille en octets, ou <code>abbrev</code> pour une taille
en Ko ou Mo selon son importance ; par exemple, une taille de 1024
octets sera affich&eacute;e sous la forme "1K".</p>
<div class="example"><p><code>
&lt;!--#config sizefmt="abbrev" --&gt;
</code></p></div>
</dd>
<dt><code>timefmt</code></dt>
<dd><p>La valeur est une cha&icirc;ne que pourra utiliser la fonction de la
biblioth&egrave;que standard <code>strftime(3)</code> lors de l'affichage
des dates.</p>
<div class="example"><p><code>
&lt;!--#config timefmt=""%R, %B %d, %Y"" --&gt;
</code></p></div>
</dd>
</dl>
<h3 id="element.echo">L'&eacute;l&eacute;ment echo</h3>
<p>Cette commande affiche le contenu d'une des <a href="#includevars">variables include</a> d&eacute;finies ci-dessous. Si
la variable n'est pas d&eacute;finie, le r&eacute;sultat est d&eacute;termin&eacute; par la
valeur de la directive <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code>. Le format d'affichage des dates est
d&eacute;fini par l'attribut <code>timefmt</code> de la commande
config.</p>
<p>Attributs:</p>
<dl>
<dt><code>var</code></dt>
<dd>La valeur est le nom de la variable &agrave; afficher.</dd>
<dt><code>decoding</code></dt>
<dd><p>Sp&eacute;cifie si Apache doit effectuer un d&eacute;codage dans la
variable avant son traitement ult&eacute;rieur. La valeur par d&eacute;faut est
<code>none</code>, et dans ce cas, aucun d&eacute;codage n'est effectu&eacute;.
Si la valeur est <code>url</code>, un d&eacute;codage de type URL sera
effectu&eacute; (il s'agit du codage de type %-encoding utilis&eacute; dans les
URLs des liens, etc...). Si la valeur est <code>urlencoded</code>,
c'est un d&eacute;codage des &eacute;l&eacute;ments de type
application/x-www-form-urlencode (que l'on trouve dans les cha&icirc;nes
de param&egrave;tres) qui sera effectu&eacute;. Si la valeur est
<code>base64</code>, un
decodage de type base64 sera effectu&eacute;, et si elle est
<code>entity</code>, c'est un d&eacute;codage des entit&eacute;s HTML qui sera
effectu&eacute;. Ce d&eacute;codage est effectu&eacute; avant tout codage ult&eacute;rieur de
la variable. Il est possible d'effectuer plusieurs d&eacute;codages en
sp&eacute;cifiant plusieurs valeurs s&eacute;par&eacute;es par des virgules. Les
sp&eacute;cifications de d&eacute;codages restent valables jusqu'au prochain
attribut de d&eacute;codage, ou la fin de l'&eacute;l&eacute;ment.</p>
<p>Pour &ecirc;tre pris en compte, l'attribut de <code>d&eacute;codage</code>
doit <em>pr&eacute;c&eacute;der</em> l'attribut <code>var</code> correspondant.</p>
</dd>
<dt><code>encoding</code></dt>
<dd><p>Sp&eacute;cifie la mani&egrave;re dont Apache va coder les caract&egrave;res
sp&eacute;ciaux que la variable contient avant leur affichage. S'il est
d&eacute;fini &agrave; <code>none</code>, aucun codage ne sera effectu&eacute;. S'il
est d&eacute;fini &agrave; <code>url</code>, un codage de type URL sera effectu&eacute;
(aussi connu sous le nom de codage avec caract&egrave;res % , il convient
pour les URLS des liens, etc...). S'il est d&eacute;fini &agrave;
<code>urlencoded</code>, c'est un codage compatible
application/x-www-form-urlencoded qui sera effectu&eacute; (&agrave; utiliser
dans les cha&icirc;nes de param&egrave;tres). S'il est d&eacute;fini &agrave;
<code>base64</code>, c'est un encodage de type base64 qui sera
effectu&eacute;. Au d&eacute;but d'un &eacute;l&eacute;ment
<code>echo</code>, la valeur par d&eacute;faut est d&eacute;finie &agrave;
<code>entity</code>, ce qui correspond &agrave; un codage de type entit&eacute;
(codage qui convient pour un &eacute;l&eacute;ment HTML de type bloc, comme le
paragraphe d'un texte). Cette valeur par d&eacute;faut peut &ecirc;tre modifi&eacute;e
en ajoutant un attribut <code>encoding</code>, qui fera effet
jusqu'&agrave; la d&eacute;finition d'un nouvel attribut <code>encoding</code>
ou la fin de l'&eacute;l&eacute;ment echo.</p>
<p>Pour produire son effet, l'attribut <code>encoding</code> doit
pr&eacute;c&eacute;der l'attribut <code>var</code> concern&eacute;.</p>
<div class="warning">
Afin de pr&eacute;venir les attaques de type cross-site scripting, il
est recommand&eacute; de <em>toujours</em> encoder les donn&eacute;es fournies
par les utilisateurs.
</div>
<div class="example"><h3>Example</h3><p><code>
&lt;!--#echo encoding="entity" var="QUERY_STRING" --&gt;
</code></p></div>
</dd>
</dl>
<h3 id="element.exec">L'&eacute;l&eacute;ment exec</h3>
<p>La commande <code>exec</code> ex&eacute;cute la commande shell ou le
script sp&eacute;cifi&eacute;. Elle n&eacute;cessite le chargement du module
<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. Si <code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>IncludesNOEXEC</code> est
d&eacute;finie, cette commande est d&eacute;sactiv&eacute;e. Les attributs disponibles
sont :</p>
<dl>
<dt><code>cgi</code></dt>
<dd><p>La valeur sp&eacute;cifie un chemin URL vers le script CGI (encod&eacute;
avec caract&egrave;res %). Si le chemin ne commence pas par un slash (/),
il est consid&eacute;r&eacute; comme relatif au document courant. Le document
r&eacute;f&eacute;renc&eacute; par ce chemin est invoqu&eacute; en tant que script CGI, m&ecirc;me
s'il n'est pas cens&eacute; &ecirc;tre reconnu comme tel par le serveur. Les
scripts CGI doivent cependant &ecirc;tre activ&eacute;s dans le r&eacute;pertoire qui
contient les scripts (via la directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> ou l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>ExecCGI</code>).</p>
<p>Le <code>PATH_INFO</code> et la cha&icirc;ne d'arguments
(<code>QUERY_STRING</code>) de la requ&ecirc;te originale du client sont
fournis au script CGI ; ils <em>ne peuvent pas</em> &ecirc;tre sp&eacute;cifi&eacute;s
dans le chemin de l'URL. Le script disposera des variables include
en plus de l'environnement standard <a href="mod_cgi.html">CGI</a>.</p>
<div class="example"><h3>Exemple</h3><p><code>
&lt;!--#exec cgi="/cgi-bin/exemple.cgi" --&gt;
</code></p></div>
<p>Si, &agrave; la place d'un flux de sortie, le script renvoie un
en-t&ecirc;te <code>Location:</code>, ce dernier sera traduit en ancrage
HTML.</p>
<p>L'&eacute;l&eacute;ment <code><a href="#includevirtual">include
virtual</a></code> doit &ecirc;tre pr&eacute;f&eacute;r&eacute; &agrave; <code>exec cgi</code>. En
particulier, si vous devez transmettre des arguments
suppl&eacute;mentaires &agrave; un programme CGI en utilisant la cha&icirc;ne
d'arguments de la requ&ecirc;te, c'est impossible avec <code>exec
cgi</code>, mais vous pouvez y parvenir avec <code>include
virtual</code> comme suit :</p>
<div class="example"><p><code>
&lt;!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" --&gt;
</code></p></div>
</dd>
<dt><code>cmd</code></dt>
<dd><p>Le serveur va ex&eacute;cuter la commande fournie en utilisant
<code>/bin/sh</code>. La commande dispose des <a href="#includevars">variables include</a>, en plus du jeu habituel
de variables CGI.</p>
<p>Il est toujours pr&eacute;f&eacute;rable d'utiliser <code><a href="#includevirtual">#include virtual</a></code> &agrave; la place de
<code>#exec cgi</code> ou <code>#exec cmd</code>. <code>#include
virtual</code> utilise le m&eacute;canisme standard des sous-requ&ecirc;tes
d'Apache pour inclure des fichiers ou des scripts. Il a fait
l'objet de tests plus approfondis et sa maintenance est mieux
suivie.</p>
<p>De plus, sur certaines plate-formes, comme Win32, et sous unix,
si l'on utilise <a href="../suexec.html">suexec</a>, il est
impossible de transmettre des arguments &agrave; une commande dans une
directive <code>exec</code>, &agrave; moins d'ins&eacute;rer des espaces dans la
commande. Ainsi, alors que ce qui suit fonctionnera sous unix avec
une configuration sans suexec, l'effet produit ne sera pas celui
d&eacute;sir&eacute; sous Win32, ou dans le cas de l'utilisation de suexec
:</p>
<div class="example"><p><code>
&lt;!--#exec cmd="perl /chemin/vers/script_perl arg1 arg2" --&gt;
</code></p></div>
</dd>
</dl>
<h3 id="element.fsize">L'&eacute;l&eacute;ment fsize</h3>
<p>Cette commande permet d'afficher la taille du fichier sp&eacute;cifi&eacute;
en fonction des sp&eacute;cifications de format de <code>sizefmt</code>.
Attributs :</p>
<dl>
<dt><code>file</code></dt>
<dd>La valeur est le chemin du fichier, relatif au r&eacute;pertoire
contenant le document en cours d'interpr&eacute;tation.
<div class="example"><p><code>
Ce fichier a une taille de &lt;!--#fsize file="mod_include.html"
--&gt; octets.
</code></p></div>
La valeur de <code>file</code> ne peut pas faire r&eacute;f&eacute;rence &agrave; un
fichier situ&eacute; &agrave; un niveau sup&eacute;rieur de l'arborescence du r&eacute;pertoire
courant ou en dehors de la racine des documents ; il ne peut donc
ni commencer par un slash, ni contenir la s&eacute;quence de caract&egrave;res
<code>../</code>. Si c'est le cas, le message d'erreur <code>The
given path was above the root path</code> sera renvoy&eacute;.
</dd>
<dt><code>virtual</code></dt>
<dd>La valeur est un chemin URL (cod&eacute; avec caract&egrave;res %). S'il ne
commence pas par un slash (/), il est consid&eacute;r&eacute; comme relatif au
document courant. Notez que cette commande n'affiche <em>pas</em>
la taille de la sortie d'un programme CGI, mais la taille du
programme CGI lui-m&ecirc;me.</dd>
</dl>
<div class="example"><p><code>
Ce fichier a une taille de &lt;!--#fsize
virtual="/docs/mod/mod_include.html" --&gt; octets.
</code></p></div>
<p>Notez que dans la plupart des cas, ces deux attributs sont
identiques. Cependant, l'attribut <code>file</code> ne respecte
pas les aliases URL-space.</p>
<h3 id="element.flastmod">L'&eacute;l&eacute;ment flastmod</h3>
<p>Cette commande permet d'afficher la date de derni&egrave;re
modification du fichier sp&eacute;cifi&eacute;, en fonction des sp&eacute;cifications
de format de <code>timefmt</code>. Les attributs sont les m&ecirc;mes
que ceux de la commande <code><a href="#element.fsize">fsize</a></code>.</p>
<h3 id="element.include">L'&eacute;l&eacute;ment include</h3>
<p>Cette commande permet d'ins&eacute;rer le texte d'un autre document ou
fichier dans le fichier en cours d'interpr&eacute;tation. Tout fichier
inclus est soumis au contr&ocirc;le d'acc&egrave;s habituel. Si <a href="core.html#options">Options</a> <code>IncludesNOEXEC</code>
est d&eacute;fini pour le r&eacute;pertoire contenant le fichier
interpr&eacute;t&eacute;, seuls les documents poss&egrave;dant un
<a class="glossarylink" href="../glossary.html#type mime" title="voir glossaire">type MIME</a> de type texte
(<code>text/plain</code>, <code>text/html</code>, etc...) seront
inclus. Les scripts CGI, quant &agrave; eux, sont invoqu&eacute;s de mani&egrave;re
habituelle en utilisant l'URL compl&egrave;te fournie avec la commande, y
compris toute cha&icirc;ne d'arguments &eacute;ventuelle.</p>
<p>Un attribut d&eacute;finit le chemin du document &agrave; inclure, et peut
appara&icirc;tre plusieurs fois dans l'&eacute;l&eacute;ment &agrave; inclure ; en retour, pour
chaque attribut fourni &agrave; la commande include, une inclusion est
effectu&eacute;e. Les attributs disponibles sont :</p>
<dl>
<dt><code>file</code></dt>
<dd>La valeur est un chemin relatif au r&eacute;pertoire contenant le
fichier en cours d'interpr&eacute;tation. Elle ne peut ni contenir
<code>../</code>, ni &ecirc;tre un chemin absolu. Ainsi, vous ne pouvez
pas inclure de fichiers situ&eacute;s en dehors de l'arborescence du
site web ou dans un niveau sup&eacute;rieur &agrave; celui du fichier courant
dans cette arborescence. Il est toujours pr&eacute;f&eacute;rable d'utiliser
l'attribut <code>virtual</code>.</dd>
<dt><code><a id="includevirtual" name="includevirtual">virtual</a></code></dt>
<dd><p>La valeur est un chemin URL (cod&eacute; avec caract&egrave;res %). L'URL
ne peut contenir qu'un chemin et une cha&icirc;ne d'arguments
&eacute;ventuelle, &agrave; l'exclusion de tout protocole ou nom d'h&ocirc;te. S'il ne
commence pas par un slash (/), il est consid&eacute;r&eacute; comme relatif au
document courant.</p>
<p>Une URL est construite &agrave; partir de l'attribut, et la sortie que
renverrait le serveur si l'URL &eacute;tait acc&eacute;d&eacute;e par le client est
incluse dans la sortie interpr&eacute;t&eacute;e. Les inclusions de fichiers
peuvent ainsi &ecirc;tre imbriqu&eacute;es.</p>
<p>Si l'URL sp&eacute;cifi&eacute;e correspond &agrave; un programme CGI, le programme
sera ex&eacute;cut&eacute;, et son flux de sortie ins&eacute;r&eacute; &agrave; la place de la
directive dans le fichier interpr&eacute;t&eacute;. Vous pouvez ins&eacute;rer une
cha&icirc;ne d'arguments dans une URL correspond &agrave; un programme CGI
:</p>
<div class="example"><p><code>
&lt;!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" --&gt;
</code></p></div>
<p><code>include virtual</code> doit &ecirc;tre pr&eacute;f&eacute;r&eacute; &agrave; <code>exec
cgi</code> pour inclure le flux de sortie d'un programme CGI dans
un document HTML.</p>
<p>Si la directive <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code> est correctement
d&eacute;finie et valide pour le fichier inclus, les tentatives de
requ&ecirc;tes POST vers le document HTML qui inclut des fichiers seront
transmises aux sous-requ&ecirc;tes en tant que requ&ecirc;tes POST
elles-m&ecirc;mes. Sans cette directive, toutes les sous-requ&ecirc;tes sont
trait&eacute;es en tant que requ&ecirc;tes GET.</p>
</dd>
<dt><code>onerror</code></dt>
<dd><p>La valeur est un chemin-URL (cod&eacute;-%) qui est affich&eacute; si une
tentative pr&eacute;c&eacute;dente d'inclure un fichier ou un attribut virtuel a
&eacute;chou&eacute;. Pour produire son effet, cet attribut doit &ecirc;tre sp&eacute;cifi&eacute;
apr&egrave;s le fichier ou les attributs virtuels concern&eacute;s. Si la
tentative d'inclure le chemin onerror &eacute;choue, ou si onerror n'est
pas sp&eacute;cifi&eacute;, c'est le message d'erreur par d&eacute;faut qui sera
inclus.</p>
<div class="example"><pre class="prettyprint lang-html"># Exemple simple<br>
&lt;!--#include virtual="/not-exist.html" onerror="/error.html" --&gt;</pre>
</div>
<div class="example"><pre class="prettyprint lang-html"># Chemins onerror d&eacute;di&eacute;s<br>
&lt;!--#include virtual="/path-a.html" onerror="/error-a.html" virtual="/path-b.html" onerror="/error-b.html" --&gt;</pre>
</div>
</dd>
</dl>
<h3 id="element.printenv">L'&eacute;l&eacute;ment printenv</h3>
<p>Cette commande affiche la liste en mode texte de toutes les variables et de
leurs valeurs. Les caract&egrave;res sp&eacute;ciaux sont encod&eacute;s <code>entity</code> avant
d'&ecirc;tre affich&eacute;s (se reporter &agrave; l'&eacute;l&eacute;ment <code><a href="#element.echo">echo</a></code> pour plus de d&eacute;tails). Cette
commande ne comporte pas d'attributs.</p>
<div class="example"><h3>Exemple</h3><p><code>
&lt;pre&gt;
&lt;!--#printenv --&gt;
&lt;/pre&gt;
</code></p></div>
<h3 id="element.set">L'&eacute;l&eacute;ment set</h3>
<p>Cette commande permet de d&eacute;finir la valeur d'une variable. Les
attributs sont :</p>
<dl>
<dt><code>var</code></dt>
<dd>Le nom de la variable &agrave; d&eacute;finir.</dd>
<dt><code>value</code></dt>
<dd>La valeur &agrave; affecter &agrave; la variable.</dd>
<dt><code>decoding</code></dt>
<dd><p>Sp&eacute;cifie si Apache doit effectuer un d&eacute;codage dans la
variable avant son traitement ult&eacute;rieur. La valeur par d&eacute;faut est
<code>none</code>, et dans ce cas, aucun d&eacute;codage n'est effectu&eacute;.
Si la valeur est <code>url</code>, <code>urlencoded</code>,
<code>base64</code> ou
<code>entity</code>, c'est un d&eacute;codage de type URL,
application/x-www-form-urlencoded, base64 ou
entit&eacute; HTML qui sera respectivement effectu&eacute;. Il est possible
d'effectuer plusieurs d&eacute;codages en
sp&eacute;cifiant plusieurs valeurs s&eacute;par&eacute;es par des virgules. Les
sp&eacute;cifications de d&eacute;codages restent valables jusqu'au prochain
attribut de d&eacute;codage, ou la fin de l'&eacute;l&eacute;ment. Pour &ecirc;tre pris en
compte, l'attribut de <code>d&eacute;codage</code>
doit <em>pr&eacute;c&eacute;der</em> l'attribut <code>var</code> correspondant.</p>
</dd>
<dt><code>encoding</code></dt>
<dd><p>Sp&eacute;cifie la mani&egrave;re dont Apache va encoder les caract&egrave;res
sp&eacute;ciaux que la variable contient avant leur affichage. S'il est
d&eacute;fini &agrave; <code>none</code>, aucun encodage ne sera effectu&eacute;. Si la
valeur est <code>url</code>, <code>urlencoding</code>,
<code>base64</code> ou
<code>entity</code>, c'est un encodage de type URL,
application/x-www-form-urlencoded, base64 ou
entit&eacute; HTML qui sera respectivement effectu&eacute;. Il est possible de
sp&eacute;cifier plusieurs types d'encodage en les s&eacute;parant par des
virgules. La sp&eacute;cification du type d'encodage fera effet
jusqu'&agrave; la d&eacute;finition d'un nouvel attribut encoding
ou la fin de l'&eacute;l&eacute;ment. Pour produire son effet, l'attribut <code>encoding</code> doit
pr&eacute;c&eacute;der l'attribut <code>var</code> concern&eacute;. Les encodages sont
effectu&eacute;s apr&egrave;s les op&eacute;rations de d&eacute;codage.</p>
</dd>
</dl>
<div class="example"><h3>Exemple</h3><p><code>
&lt;!--#set var="category" value="help" --&gt;
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="includevars">Variables include <a title="Lien permanent" href="#includevars" class="permalink">&para;</a></h2>
<p>&Agrave; l'instar des variables de l'environnement CGI standard, ces
variables sont mises &agrave; la disposition de la commande
<code>echo</code>, des op&eacute;rateurs conditionnels <code>if</code> et
<code>elif</code>, et de tout programme invoqu&eacute; par le document.</p>
<dl>
<dt><code>DATE_GMT</code></dt>
<dd>La date GMT (Greenwich Mean Time) courante.</dd>
<dt><code>DATE_LOCAL</code></dt>
<dd>La date locale courante.</dd>
<dt><code>DOCUMENT_ARGS</code></dt>
<dd>Cette variable contient la cha&icirc;ne de param&egrave;tres de la requ&ecirc;te du
document SSI actif, ou la cha&icirc;ne vide si aucune cha&icirc;ne de param&egrave;tres de
requ&ecirc;te n'est incluse. Pour les sous-requ&ecirc;tes invoqu&eacute;es par la directive
SSI <code>include</code>, <code>QUERY_STRING</code> contiendra la cha&icirc;ne
de param&egrave;tres de la sous-requ&ecirc;te et <code>DOCUMENT_ARGS</code> la cha&icirc;ne
de param&egrave;tres du document SSI (disponible &agrave; partir de la version 2.4.19 du
serveur HTTP Apache).</dd>
<dt><code>DOCUMENT_NAME</code></dt>
<dd>Le nom de base du fichier demand&eacute; par l'utilisateur (sans son
chemin).</dd>
<dt><code>DOCUMENT_PATH_INFO</code></dt>
<dd>La partie terminale du chemin du fichier. Voir la directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> pour plus d'informations &agrave;
propos de <code>PATH_INFO</code>.</dd>
<dt><code>DOCUMENT_URI</code></dt>
<dd>Le chemin URL (caract&egrave;res % d&eacute;cod&eacute;s) du document demand&eacute; par
l'utilisateur. Notez que dans le cas d'inclusions de fichiers
imbriqu&eacute;es, il ne s'agit <em>pas</em> de l'URL du document
courant. Notez &eacute;galement que si l'URL est modifi&eacute;e en interne (par
exemple via une directive <code class="directive"><a href="../mod/mod_alias.html#alias">alias</a></code> ou <code class="directive"><a href="../mod/mod_dir.html#directoryindex">directoryindex</a></code>), c'est l'URL modifi&eacute;e
que contiendra la variable.</dd>
<dt><code>LAST_MODIFIED</code></dt>
<dd>La date de derni&egrave;re modification du document demand&eacute; par
l'utilisateur.</dd>
<dt><code>QUERY_STRING_UNESCAPED</code></dt>
<dd>Si une cha&icirc;ne d'arguments est pr&eacute;sente dans la requ&ecirc;te pour le
document SSI actif, elle sera affect&eacute;e &agrave;
cette variable, les caract&egrave;res %-d&eacute;cod&eacute;s, et &eacute;ventuellement
<em>&eacute;chapp&eacute;s</em> pour qu'ils ne soient pas interpr&eacute;t&eacute;s par le
shell (les caract&egrave;res sp&eacute;ciaux comme <code>&amp;</code>,etc...
sont pr&eacute;c&eacute;d&eacute;s d'anti-slashes). Cette variable n'est pas d&eacute;finie si aucune
cha&icirc;ne d'arguments n'est pr&eacute;sente. Utilisez <code>DOCUMENT_ARGS</code> si
l'&eacute;chappement des caract&egrave;res du shell n'est pas souhait&eacute;.</dd>
<dt><code>USER_NAME</code></dt>
<dd>Le nom d'utilisateur du propri&eacute;taire du fichier.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="substitution">Substitution de variable <a title="Lien permanent" href="#substitution" class="permalink">&para;</a></h2>
<p>Une substitution de variable &agrave; l'int&eacute;rieur d'une cha&icirc;ne entre
guillemets s'effectue dans la plupart des situations o&ugrave; cette
derni&egrave;re peut raisonablement constituer un argument d'une directive
SSI. Sont concern&eacute;es les directives <code>config</code>,
<code>exec</code>, <code>flastmod</code>, <code>fsize</code>,
<code>include</code>, <code>echo</code>, et <code>set</code>. Si la
directive <code class="directive"><a href="#ssilegacyexprparser">SSILegacyExprParser</a></code> est d&eacute;finie &agrave;
<code>on</code>, la substitution s'effectue aussi dans les arguments
des op&eacute;rateurs conditionnels. Vous pouvez ins&eacute;rer
un signe dollar en tant que caract&egrave;re litt&eacute;ral dans une cha&icirc;ne en
utilisant un anti-slash :</p>
<div class="example"><p><code>
&lt;!--#set var="cur" value="\$test" --&gt;
</code></p></div>
<p>Si une r&eacute;f&eacute;rence de variable doit &ecirc;tre substitu&eacute;e au beau milieu
d'une s&eacute;quence de caract&egrave;res qui pourrait &ecirc;tre elle-m&ecirc;me consid&eacute;r&eacute;e
comme un identifiant valide, l'ambigu&iuml;t&eacute; peut &ecirc;tre lev&eacute;e en
entourant la r&eacute;f&eacute;rence d'accolades, &agrave; la mani&egrave;re du shell :</p>
<div class="example"><p><code>
&lt;!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" --&gt;
</code></p></div>
<p>Dans cet exemple, la variable <code>Zed</code> se verra affecter
la valeur "<code>X_Y</code>" si <code>REMOTE_HOST</code> et
<code>REQUEST_METHOD</code> contiennent respectivement
"<code>X</code>" et "<code>Y</code>".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flowctrl">El&eacute;ments de contr&ocirc;le d'inclusion conditionnelle <a title="Lien permanent" href="#flowctrl" class="permalink">&para;</a></h2>
<p>Les &eacute;l&eacute;ments de base du contr&ocirc;le d'inclusion conditionnelle sont
:</p>
<div class="example"><pre class="prettyprint lang-html">&lt;!--#if expr="<var>test_condition</var>" --&gt;<br>
&lt;!--#elif expr="<var>test_condition</var>" --&gt;<br>
&lt;!--#else --&gt;<br>
&lt;!--#endif --&gt;</pre>
</div>
<p>L'&eacute;l&eacute;ment <code>if</code> fonctionne de la m&ecirc;me mani&egrave;re que
la directive if d'un langage de programmation. La condition est
&eacute;valu&eacute;e et si le r&eacute;sultat est vrai, le texte qui suit jusqu'au
prochain &eacute;l&eacute;ment <code>elif</code>, <code>else</code> ou
<code>endif</code> sera inclus dans le flux de sortie.</p>
<p>Les &eacute;l&eacute;ments <code>elif</code> ou <code>else</code> permettent
d'ins&eacute;rer du texte dans le flux de sortie si
<var>test_condition</var> s'est r&eacute;v&eacute;l&eacute; faux. Ces &eacute;l&eacute;ments sont
optionnels.</p>
<p>L'&eacute;l&eacute;ment <code>endif</code> termine le bloc de traitement
conditionnel <code>if</code> et est obligatoire.</p>
<p><var>test_condition</var> est une expression bool&eacute;enne qui
emprunte la syntaxe <a href="../expr.html">ap_expr</a>. La directive
<code class="directive"><a href="#ssilegacyexprparser">SSILegacyExprParser</a></code>
permet de modifier cette syntaxe pour la rendre compatible avec
Apache HTTPD 2.2.x.</p>
<p>Le jeu de variables SSI avec l'&eacute;l&eacute;ment <code>var</code> sont
export&eacute;es vers l'environnement de la requ&ecirc;te et sont accessibles via
la fonction <code>reqenv</code>. Pour faire simple, le nom de
fonction <code>v</code> est aussi disponible dans le module
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</p>
<p>Dans l'exemple suivant, "depuis le r&eacute;seau local" sera affich&eacute; si
l'adresse IP du client appartient au sous-r&eacute;seau 10.0.0.0/8.</p>
<div class="example"><pre class="prettyprint lang-html">&lt;!--#if expr='-R "10.0.0.0/8"' --&gt;<br>
depuis le r&eacute;seau local<br>
&lt;!--#else --&gt;<br>
depuis ailleurs<br>
&lt;!--#endif --&gt;</pre>
</div>
<p>Dans l'exemple suivant, "foo vaut bar" sera affich&eacute; si la variable
<code>foo</code> contient la valeur "bar".</p>
<div class="example"><pre class="prettyprint lang-html">&lt;!--#if expr='v("foo") = "bar"' --&gt;<br>
foo vaut bar<br>
&lt;!--#endif --&gt;</pre>
</div>
<div class="note"><h3>Documentation de r&eacute;f&eacute;rence</h3>
<p>Voir aussi <a href="../expr.html">Les expressions dans le serveur
HTTP Apache</a> pour une r&eacute;f&eacute;rence compl&egrave;te et des exemples. Les
fonctions <em>restricted</em> ne sont pas disponibles dans
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="legacyexpr">Syntaxe des expressions h&eacute;rit&eacute;e <a title="Lien permanent" href="#legacyexpr" class="permalink">&para;</a></h2>
<p>Cette section d&eacute;crit la syntaxe de l'&eacute;l&eacute;ment <code>#if
expr</code> dans le cas o&ugrave; la directive <code class="directive"><a href="#ssilegacyexprparser">SSILegacyExprParser</a></code> est d&eacute;finie &agrave;
<code>on</code>.</p>
<dl>
<dt><code><var>cha&icirc;ne</var></code></dt>
<dd>vrai si <var>cha&icirc;ne</var> n'est pas vide</dd>
<dt><code><var>-A string</var></code></dt>
<dd><p>vrai si l'URL que contient la cha&icirc;ne est accessible du
point de vue de la configuration, faux sinon. Il
s'av&egrave;re utile lorsqu'un lien vers une URL doit &ecirc;tre cach&eacute; aux
utilisateurs qui ne sont pas autoris&eacute;s &agrave; voir cette URL. Notez que
le test porte sur l'autorisation d'acc&egrave;s &agrave; l'URL, et non sur son
existence.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-html">&lt;!--#if expr="-A /prive" --&gt;<br>
Cliquez &lt;a href="/prive"&gt;ici&lt;/a&gt; pour acc&eacute;der aux
informations priv&eacute;es.<br>
&lt;!--#endif --&gt;</pre>
</div>
</dd>
<dt><code><var>cha&icirc;ne1</var> = <var>cha&icirc;ne2</var><br>
<var>cha&icirc;ne1</var> == <var>cha&icirc;ne2</var><br>
<var>cha&icirc;ne1</var> != <var>cha&icirc;ne2</var></code></dt>
<dd><p>Compare <var>cha&icirc;ne1</var> &agrave; <var>cha&icirc;ne2</var>. Si
<var>cha&icirc;ne2</var> est de la forme
<code>/<var>cha&icirc;ne2</var>/</code>, elle est trait&eacute;e comme une
expression rationnelle. Les expressions rationnelles sont
impl&eacute;ment&eacute;es par le moteur <a href="http://www.pcre.org">PCRE</a>
et poss&egrave;dent la m&ecirc;me syntaxe que celles de <a href="http://www.perl.com">perl 5</a>. Notez que <code>==</code>
n'est qu'un alias pour <code>=</code> et se comporte exactement de
la m&ecirc;me mani&egrave;re que ce dernier.</p>
<p>Si vous faites une comparaison directe (<code>=</code> ou
<code>==</code>), vous pouvez extraire des parties de l'expression
rationnelle. Les parties extraites sont stock&eacute;es dans les
variables sp&eacute;ciales <code>$1</code> .. <code>$9</code>. L'ensemble
de la cha&icirc;ne correspondant &agrave; l'expression rationnelle est stock&eacute;
dans la variable sp&eacute;ciale <code>$0</code>.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-html">&lt;!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" --&gt;<br>
&lt;!--#set var="session" value="$1" --&gt;<br>
&lt;!--#endif --&gt;</pre>
</div>
</dd>
<dt><code><var>cha&icirc;ne1</var> &lt; <var>cha&icirc;ne2</var><br>
<var>cha&icirc;ne1</var> &lt;= <var>cha&icirc;ne2</var><br>
<var>cha&icirc;ne1</var> &gt; <var>cha&icirc;ne2</var><br>
<var>cha&icirc;ne1</var> &gt;= <var>cha&icirc;ne2</var></code></dt>
<dd>Compare <var>cha&icirc;ne1</var> &agrave; <var>cha&icirc;ne2</var>. Notez que les
cha&icirc;nes sont compar&eacute;es de mani&egrave;re <em>litt&eacute;rale</em> (en utilisant
<code>strcmp(3)</code>). Ainsi, la cha&icirc;ne "100" est inf&eacute;rieure &agrave;
"20".</dd>
<dt><code>( <var>test_condition</var> )</code></dt>
<dd>vrai si <var>test_condition</var> est vrai</dd>
<dt><code>! <var>test_condition</var></code></dt>
<dd>vrai si <var>test_condition</var> est faux</dd>
<dt><code><var>test_condition1</var> &amp;&amp;
<var>test_condition2</var></code></dt>
<dd>vrai si <var>test_condition1</var> et
<var>test_condition2</var> sont tous les deux vrais</dd>
<dt><code><var>test_condition1</var> ||
<var>test_condition2</var></code></dt>
<dd>vrai si au moins un des tests <var>test_condition1</var> ou
<var>test_condition2</var> est vrai</dd>
</dl>
<p>"<code>=</code>" et "<code>!=</code>" ont une priorit&eacute; sup&eacute;rieure
&agrave; "<code>&amp;&amp;</code>" et "<code>||</code>". "<code>!</code>" a
la priorit&eacute; la plus haute. Ainsi, les deux directives suivantes sont
&eacute;quivalentes :</p>
<div class="example"><pre class="prettyprint lang-html">&lt;!--#if expr="$a = test1 &amp;&amp; $b = test2" --&gt;<br>
&lt;!--#if expr="($a = test1) &amp;&amp; ($b = test2)" --&gt;</pre>
</div>
<p>Les op&eacute;rateurs bool&eacute;ens <code>&amp;&amp;</code> et
<code>||</code> ont la m&ecirc;me priorit&eacute;. Ainsi, si vous voulez
augmenter la priorit&eacute; d'un de ces op&eacute;rateurs, vous devez utiliser
des parenth&egrave;ses.</p>
<p>Tout ce qui n'est pas reconnu comme variable ou op&eacute;rateur est
trait&eacute; comme une cha&icirc;ne. Les cha&icirc;nes peuvent aussi &ecirc;tre entour&eacute;es
d'apostrophes : <code>'cha&icirc;ne'</code>. Les cha&icirc;nes sans apostrophe
ne peuvent pas contenir d'espaces (espaces ou tabulations) car
ceux-ci servent &agrave; s&eacute;parer certains &eacute;l&eacute;ments comme les variables. Si
plusieurs cha&icirc;nes se trouvent dans une ligne, elles sont concat&eacute;n&eacute;es
en utilisant des espaces. Ainsi,</p>
<div class="example"><p><code><var>cha&icirc;ne1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>cha&icirc;ne2</var></code> devient <code><var>cha&icirc;ne1</var>&nbsp;<var>cha&icirc;ne2</var></code><br>
<br>
et<br>
<br>
<code>'<var>cha&icirc;ne1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>cha&icirc;ne2</var>'</code> devient <code><var>cha&icirc;ne1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>cha&icirc;ne2</var></code>.</p></div>
<div class="note"><h3>Optimisation des expressions bool&eacute;ennes</h3>
<p>Si les expressions atteignent une complexit&eacute; suffisante pour
ralentir les traitements de mani&egrave;re significative, vous pouvez
essayer de les optimiser en fonction des r&egrave;gles d'&eacute;valuation :</p>
<ul>
<li>Les expressions sont &eacute;valu&eacute;es de la gauche vers la droite</li>
<li>Les op&eacute;rateurs bool&eacute;ens binaires (<code>&amp;&amp;</code> et
<code>||</code>) font l'objet d'une &eacute;valuation abr&eacute;g&eacute;e chaque fois
que cela est possible. En d'autres termes, et selon la r&egrave;gle
ci-dessus, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> &eacute;value tout d'abord la
partie gauche de l'expression. Si le r&eacute;sultat de l'&eacute;valuation de
cette partie gauche suffit &agrave; d&eacute;terminer le r&eacute;sultat final,
l'&eacute;valuation s'arr&ecirc;te ici. Dans le cas contraire, la partie droite
est &eacute;valu&eacute;e, et le r&eacute;sultat final tient compte des r&eacute;sultats des
&eacute;valuations des parties gauche et droite.</li>
<li>L'&eacute;valuation abr&eacute;g&eacute;e est d&eacute;sactiv&eacute;e tant qu'il reste des
expressions r&eacute;guli&egrave;res &agrave; traiter. Ces derni&egrave;res doivent &ecirc;tre
&eacute;valu&eacute;es afin de d&eacute;finir les variables correspondant aux
r&eacute;f&eacute;rences arri&egrave;res (<code>$1</code> .. <code>$9</code>).</li>
</ul>
<p>Si vous voulez d&eacute;terminer la mani&egrave;re dont une expression est
trait&eacute;e, vous pouvez recompiler <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> en
utilisant l'option de compilation <code>-DDEBUG_INCLUDE</code>.
Ceci a pour effet d'ins&eacute;rer, pour chaque expression interpr&eacute;t&eacute;e,
des informations &eacute;tiquet&eacute;es, l'arbre d'interpr&eacute;tation et la
mani&egrave;re dont elle est &eacute;valu&eacute;e au sein du flux de sortie envoy&eacute; au
client.</p>
</div>
<div class="note"><h3>Slashes d'&eacute;chappement dans les expressions
rationnelles</h3>
<p>Tous les caract&egrave;res slashes qui ne sont pas des s&eacute;parateurs dans
votre expression rationnelle doivent &ecirc;tre &eacute;chapp&eacute;s, et ceci sans
tenir compte de leur signification du point de vue du moteur
d'expressions rationnelles.</p>
</div>
<div class="note"><h3>Documentation de r&eacute;f&eacute;rence</h3>
<p>Voir le document <a href="../expr.html">Les expressions dans le
serveur HTTP Apache</a>, pour une r&eacute;f&eacute;rence compl&egrave;te et des exemples.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssiendtag">Directive <span id="SSIEndTag">SSIEndTag</span> <a title="Lien permanent" href="#ssiendtag" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha&icirc;ne qui termine l'&eacute;l&eacute;ment include</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIEndTag <var>tag</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSIEndTag "--&gt;"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Cette directive permet de modifier la cha&icirc;ne que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interpr&egrave;te comme la fin d'un &eacute;l&eacute;ment
include.</p>
<pre class="prettyprint lang-config">SSIEndTag "%&gt;"</pre>
<div class="warning">
La valeur ne doit pas contenir d'espace.
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#ssistarttag">SSIStartTag</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssierrormsg">Directive <span id="SSIErrorMsg">SSIErrorMsg</span> <a title="Lien permanent" href="#ssierrormsg" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Message d'erreur affich&eacute; lorsqu'une erreur SSI
survient</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIErrorMsg <var>message</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSIErrorMsg "[an error occurred while processing this
directive]"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>La directive <code class="directive">SSIErrorMsg</code> permet de
modifier le message d'erreur affich&eacute; lorsqu'une erreur SSI survient.
Pour les serveurs en production, il est recommand&eacute; de modifier le
message d'erreur par d&eacute;faut en <code>"&lt;!-- Error
--&gt;"</code>, de fa&ccedil;on &agrave; ce que le message ne soit pas
pr&eacute;sent&eacute; &agrave; l'utilisateur.</p>
<p>Cette directive a le m&ecirc;me effet que l'&eacute;l&eacute;ment
<code>&lt;!--#config errmsg=<var>message</var> --&gt;</code>.</p>
<pre class="prettyprint lang-config">SSIErrorMsg "&lt;!-- Error --&gt;"</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssietag">Directive <span id="SSIETag">SSIETag</span> <a title="Lien permanent" href="#ssietag" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D&eacute;finit si des en-t&ecirc;tes ETags sont g&eacute;n&eacute;r&eacute;s par le serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIETag on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSIETag off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Dans le cas g&eacute;n&eacute;ral, un fichier filtr&eacute; par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des &eacute;l&eacute;ments soit
g&eacute;n&eacute;r&eacute;s dynamiquement, soit &eacute;ventuellement modifi&eacute;s ind&eacute;pendemment
du fichier original. En cons&eacute;quence, il est demand&eacute; par d&eacute;faut au
serveur de ne pas g&eacute;n&eacute;rer d'en-t&ecirc;te <code>ETag</code> &agrave; la r&eacute;ponse
en ajoutant <code>no-etag</code> aux informations de requ&ecirc;te.</p>
<p>Ce comportement peut &ecirc;tre modifi&eacute; via la directive
<code class="directive">SSIETag</code> qui permet au serveur de g&eacute;n&eacute;rer un
en-t&ecirc;te <code>ETag</code>. On peut aussi l'utiliser pour la mise
en cache de la sortie. Notez qu'un serveur d'arri&egrave;re-plan ou un
g&eacute;n&eacute;rateur de contenu dynamique peut lui-m&ecirc;me g&eacute;n&eacute;rer un en-t&ecirc;te
<code>ETag</code>, en ignorant l'information <code>no-etag</code>,
cet en-t&ecirc;te <code>ETag</code> &eacute;tant transmis par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sans tenir compte de la d&eacute;finition de
la pr&eacute;sente directive. La directive <code class="directive">SSIETag</code>
peut prendre une des valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
<dd><code>no-etag</code> sera ajout&eacute; aux informations de
requ&ecirc;te, et il sera demand&eacute; au serveur de ne pas g&eacute;n&eacute;rer
d'en-t&ecirc;te <code>ETag</code>. Lorsqu'un serveur ignore la valeur
de <code>no-etag</code> et g&eacute;n&egrave;re tout de m&ecirc;me un en-t&ecirc;te
<code>ETag</code>, ce dernier sera respect&eacute;.</dd>
<dt><code>on</code></dt>
<dd>Les en-t&ecirc;tes <code>ETag</code> existants seront respect&eacute;s,
et ceux g&eacute;n&eacute;r&eacute;s par le serveur seront ajout&eacute;s &agrave; la r&eacute;ponse.</dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssilastmodified">Directive <span id="SSILastModified">SSILastModified</span> <a title="Lien permanent" href="#ssilastmodified" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D&eacute;finit si des en-t&ecirc;tes <code>Last-Modified</code> sont
g&eacute;n&eacute;r&eacute;s par le serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSILastModified on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSILastModified off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Dans le cas g&eacute;n&eacute;ral, un fichier filtr&eacute; par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des &eacute;l&eacute;ments soit
g&eacute;n&eacute;r&eacute;s dynamiquement, soit &eacute;ventuellement modifi&eacute;s ind&eacute;pendemment
du fichier original. En cons&eacute;quence, l'en-t&ecirc;te
<code>Last-Modified</code> est supprim&eacute; par d&eacute;faut de la r&eacute;ponse.</p>
<p>La directive <code class="directive">SSILastModified</code> permet de
modifier ce comportement en faisant en sorte que l'en-t&ecirc;te
<code>Last-Modified</code> soit respect&eacute; s'il est d&eacute;j&agrave; pr&eacute;sent, ou
d&eacute;fini dans le cas contraire. On peut aussi l'utiliser pour la mise
en cache de la sortie. La directive
<code class="directive">SSILastModified</code> peut prendre une des
valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
<dd>L'en-t&ecirc;te <code>Last-Modified</code> sera supprim&eacute; des
r&eacute;ponses, &agrave; moins que la directive <code class="directive"><a href="#xbithack">XBitHack</a></code> ne soit d&eacute;finie &agrave;
<code>full</code> comme d&eacute;crit plus loin.</dd>
<dt><code>on</code></dt>
<dd>L'en-t&ecirc;te <code>Last-Modified</code> sera respect&eacute; s'il est
d&eacute;j&agrave; pr&eacute;sent, et ajout&eacute; &agrave; la r&eacute;ponse si cette derni&egrave;re est un
fichier et si l'en-t&ecirc;te est manquant. La directive <code class="directive">SSILastModified</code> l'emporte sur
la directive <code class="directive"><a href="#xbithack">XBitHack</a></code>.</dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssilegacyexprparser">Directive <span id="SSILegacyExprParser">SSILegacyExprParser</span> <a title="Lien permanent" href="#ssilegacyexprparser" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le mode de compatibilit&eacute; pour les expressions
conditionnelles.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSILegacyExprParser on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSILegacyExprParser off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible &agrave; partir de la version 2.3.13.</td></tr>
</table>
<p>Depuis la version 2.3.13, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> a adopt&eacute;
la nouvelle syntaxe <a href="../expr.html">ap_expr</a> pour ses
expressions conditionnelles dans les &eacute;l&eacute;ments de contr&ocirc;le de flux
<code>#if</code>. Cette directive permet de r&eacute;activer l'<a href="#legacyexpr">ancienne syntaxe</a> qui est compatible avec les
versions 2.2.x et ant&eacute;rieures d'Apache HTTPD.
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssistarttag">Directive <span id="SSIStartTag">SSIStartTag</span> <a title="Lien permanent" href="#ssistarttag" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha&icirc;ne qui marque le d&eacute;but d'un &eacute;l&eacute;ment
include</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIStartTag <var>tag</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSIStartTag "&lt;!--#"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Cette directive permet de modifier la cha&icirc;ne que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interpr&egrave;te comme le d&eacute;but d'un &eacute;l&eacute;ment
include.</p>
<p>Cette option peut vous &ecirc;tre utile si vous avez deux serveurs qui
interpr&egrave;tent un fichier avec des commandes diff&eacute;rentes (et
&eacute;ventuellement &agrave; des moments diff&eacute;rents).</p>
<pre class="prettyprint lang-config">SSIStartTag "&lt;%"
SSIEndTag "%&gt;"</pre>
<div class="warning">
La valeur ne doit pas contenir d'espace.
</div>
<p>Avec l'exemple ci-dessus, qui d&eacute;finit aussi une directive
<code class="directive"><a href="#ssiendtag">SSIEndTag</a></code>, vous pourrez
inscrire des directives SSI comme dans l'exemple suivant :</p>
<div class="example"><h3>Directives SSI avec marques de d&eacute;but et de fin
personnalis&eacute;es</h3><p><code>
&lt;%printenv %&gt;
</code></p></div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#ssiendtag">SSIEndTag</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssitimeformat">Directive <span id="SSITimeFormat">SSITimeFormat</span> <a title="Lien permanent" href="#ssitimeformat" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration du format d'affichage des dates</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSITimeFormat <var>cha&icirc;ne de formatage</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Cette directive permet de modifier le format d'affichage des
variables d'environnement <code>DATE</code>. La <var>cha&icirc;ne de
formatage</var> est identique &agrave; celle de la fonction
<code>strftime(3)</code> de la biblioth&egrave;que C standard.</p>
<p>Cette directive a le m&ecirc;me effet que l'&eacute;l&eacute;ment
<code>&lt;!--#config timefmt=<var>cha&icirc;ne de formatage</var>
--&gt;</code>.</p>
<pre class="prettyprint lang-config">SSITimeFormat "%R, %B %d, %Y"</pre>
<p>Avec l'exemple ci-dessus, les dates seront affich&eacute;es dans le
style "22:26, June 14, 2002".</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="ssiundefinedecho">Directive <span id="SSIUndefinedEcho">SSIUndefinedEcho</span> <a title="Lien permanent" href="#ssiundefinedecho" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha&icirc;ne &agrave; afficher lorsqu'on tente d'extraire le contenu
d'une variable non d&eacute;finie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIUndefinedEcho <var>cha&icirc;ne</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>SSIUndefinedEcho "(none)"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>Cette directive permet de modifier la cha&icirc;ne affich&eacute;e par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> lorsqu'on tente d'extraire le contenu
d'une variable non d&eacute;finie.</p>
<pre class="prettyprint lang-config">SSIUndefinedEcho "&lt;!-- nondef --&gt;"</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="xbithack">Directive <span id="XBitHack">XBitHack</span> <a title="Lien permanent" href="#xbithack" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interpr&egrave;te les directives SSI dans les fichiers dont le bit
d'ex&eacute;cution est positionn&eacute;</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>XBitHack on|off|full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>XBitHack off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
</table>
<p>La directive <code class="directive">XBitHack</code> permet de contr&ocirc;ler
l'interpr&eacute;tation des documents html standards. Elle n'affecte que
les fichiers dont le <a class="glossarylink" href="../glossary.html#type mime" title="voir glossaire">type MIME</a> est
<code>text/html</code>. <code class="directive">XBitHack</code> peut prendre
les valeurs suivantes :</p>
<dl>
<dt><code>off</code></dt>
<dd>Aucun traitement particulier pour les fichiers
ex&eacute;cutables.</dd>
<dt><code>on</code></dt>
<dd>Tout fichier <code>text/html</code> dont le bit d'ex&eacute;cution
est positionn&eacute; pour le propri&eacute;taire sera trait&eacute; en tant que
document html interpr&eacute;t&eacute; par le serveur.</dd>
<dt><code>full</code></dt>
<dd>Identique &agrave; <code>on</code>, avec test du bit d'ex&eacute;cution pour
le groupe. Si ce dernier est positionn&eacute;, la date de <code>derni&egrave;re
modification</code> du fichier renvoy&eacute; est d&eacute;finie &agrave; la date de
derni&egrave;re modification du fichier. Dans le cas contraire, aucune
date de derni&egrave;re modification n'est renvoy&eacute;e. Le positionnement de
ce bit permet aux clients et aux mandataires de g&eacute;rer la mise en
cache du r&eacute;sultat de la requ&ecirc;te.
<div class="note"><h3>Note</h3>
<p>Il est recommand&eacute; de n'utiliser l'option full que dans le cas
o&ugrave; vous &ecirc;tes certain que le bit d'ex&eacute;cution du groupe est non
positionn&eacute; pour les scripts SSI qui pourraient effectuer l'<code>#include</code> d'un programme CGI ou bien produire des sorties
diff&eacute;rentes &agrave; chaque acc&egrave;s (ou seraient susceptibles d'&ecirc;tre
modifi&eacute;es au cours des requ&ecirc;tes ult&eacute;rieures).</p>
<p>Lorsqu'elle est d&eacute;finie &agrave; <code>on</code>, la directive
<code class="directive"><a href="#ssilastmodified">SSILastModified</a></code>
l'emporte sur la directive <code class="directive">XBitHack</code>.</p>
</div>
</dd>
</dl>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_include.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_include.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_include.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '&#9776;';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>