File: //usr/local/apache.backup/manual/mod/mod_include.html.fr
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_include - Serveur Apache HTTP Version 2.4</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" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.4</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_include</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_include.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_include.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/mod_include.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Documents html interpr�t�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�de�Module:</a></th><td>include_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�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�l� via des
commentaires SGML sp�cialement format�s, aussi nomm�s
<dfn>�l�ments</dfn>. Ces �l�ments permettent l'insertion
conditionnelle de texte, l'inclusion d'autres fichiers ou
programmes, ainsi que la d�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�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�ments de contr�le d'inclusion conditionnelle</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#legacyexpr">Syntaxe des expressions h�rit�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>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><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enabling" id="enabling">Activation des SSI</a></h2>
<p>Les SSI sont impl�ment�s par le <a href="../filter.html">filtre</a> <code>INCLUDES</code>. Si des
documents contenant des directives SSI poss�dent une extension
.shtml, les directives suivantes indiqueront � Apache de les
interpr�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 �tre d�finie pour les r�pertoires qui
contiennent les fichiers shtml (en g�n�ral dans une section
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, mais
cette option peut �galement �tre d�finie dans un fichier
<code>.htaccess</code> si <code><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> Options</code> a �t� d�fini pour le
r�pertoire consid�r�) :</p>
<pre class="prettyprint lang-config">Options +Includes</pre>
<p>Pour des raisons de compatibilit� 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><a name="pathinfo" id="pathinfo">PATH_INFO et SSI</a></h2>
<p>Les fichiers trait�s dans le cadre des SSI n'acceptent plus par
d�faut les requ�tes avec <code>PATH_INFO</code> (les informations
relatives au chemin en fin de requ�te). La directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> permet de configurer le
serveur de fa�on � ce qu'il accepte ce genre de requ�te.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="elements" id="elements">El�ments disponibles</a></h2>
<p>Le document est interpr�t� comme un document HTML, avec des
commandes sp�ciales incluses sous forme de commentaires SGML. La
syntaxe d'une commande est la suivante : </p>
<div class="example"><p><code>
<!--#<var>�l�ment</var> <var>attribut</var>=<var>valeur</var>
<var>attribut</var>=<var>valeur</var> ... -->
</code></p></div>
<p>Les valeurs sont souvent entour�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>--></code>) doit �tre pr�c�d� d'un espace afin
d'�tre s�r qu'il ne soit pas consid�r� comme un �l�ment de commande
SSI. Notez aussi que le d�limiteur de d�but <code><!--#</code>
est <em>un</em> �l�ment de commande et ne doit donc pas contenir
d'espace.</p>
<p>La table suivante contient la liste des �l�ments autoris�s :</p>
<table class="bordered">
<tr><th>El�ment</th><th>Description</th></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�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�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�finit la valeur d'une variable</td></tr>
</table>
<p>Les �l�ments SSI peuvent �tre d�finis par d'autres modules que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. � ce titre, l'�l�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�.</p>
<h3><a name="element.config" id="element.config">L'�l�ment config</a></h3>
<p>Cette commande contr�le divers aspects de l'interpr�tation. Les
attributs valides sont :</p>
<dl>
<dt><code>echomsg</code> (<em>Versions 2.1 et sup�rieures
d'Apache</em>)</dt>
<dd><p>La valeur est un message qui sera envoy� au client si
l'�l�ment <code><a href="#element.echo">echo</a></code> tente
d'afficher le contenu d'une variable non d�finie. Cet attribut
l'emporte sur toute directive <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code>.</p>
<div class="example"><p><code>
<!--#config echomsg="[Valeur non d�finie]" -->
</code></p></div>
</dd>
<dt><code>errmsg</code></dt>
<dd><p>La valeur est un message qui sera envoy� au client si une
erreur survient lors de l'interpr�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>
<!--#config errmsg="[Zut, quelque chose s'est mal pass�.]" -->
</code></p></div>
</dd>
<dt><code>sizefmt</code></dt>
<dd><p>La valeur d�finit l'unit� employ�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�e sous la forme "1K".</p>
<div class="example"><p><code>
<!--#config sizefmt="abbrev" -->
</code></p></div>
</dd>
<dt><code>timefmt</code></dt>
<dd><p>La valeur est une cha�ne que pourra utiliser la fonction de la
biblioth�que standard <code>strftime(3)</code> lors de l'affichage
des dates.</p>
<div class="example"><p><code>
<!--#config timefmt=""%R, %B %d, %Y"" -->
</code></p></div>
</dd>
</dl>
<h3><a name="element.echo" id="element.echo">L'�l�ment echo</a></h3>
<p>Cette commande affiche le contenu d'une des <a href="#includevars">variables include</a> d�finies ci-dessous. Si
la variable n'est pas d�finie, le r�sultat est d�termin� par la
valeur de la directive <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code>. Le format d'affichage des dates est
d�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 � afficher.</dd>
<dt><code>decoding</code></dt>
<dd><p>Sp�cifie si Apache doit effectuer un d�codage dans la
variable avant son traitement ult�rieur. La valeur par d�faut est
<code>none</code>, et dans ce cas, aucun d�codage n'est effectu�.
Si la valeur est <code>url</code>, un d�codage de type URL sera
effectu� (il s'agit du codage de type %-encoding utilis� dans les
URLs des liens, etc...). Si la valeur est <code>urlencoded</code>,
c'est un d�codage des �l�ments de type
application/x-www-form-urlencode (que l'on trouve dans les cha�nes
de param�tres) qui sera effectu�. Si la valeur est
<code>base64</code>, un
decodage de type base64 sera effectu�, et si elle est
<code>entity</code>, c'est un d�codage des entit�s HTML qui sera
effectu�. Ce d�codage est effectu� avant tout codage ult�rieur de
la variable. Il est possible d'effectuer plusieurs d�codages en
sp�cifiant plusieurs valeurs s�par�es par des virgules. Les
sp�cifications de d�codages restent valables jusqu'au prochain
attribut de d�codage, ou la fin de l'�l�ment.</p>
<p>Pour �tre pris en compte, l'attribut de <code>d�codage</code>
doit <em>pr�c�der</em> l'attribut <code>var</code> correspondant.</p>
</dd>
<dt><code>encoding</code></dt>
<dd><p>Sp�cifie la mani�re dont Apache va coder les caract�res
sp�ciaux que la variable contient avant leur affichage. S'il est
d�fini � <code>none</code>, aucun codage ne sera effectu�. S'il
est d�fini � <code>url</code>, un codage de type URL sera effectu�
(aussi connu sous le nom de codage avec caract�res % , il convient
pour les URLS des liens, etc...). S'il est d�fini �
<code>urlencoded</code>, c'est un codage compatible
application/x-www-form-urlencoded qui sera effectu� (� utiliser
dans les cha�nes de param�tres). S'il est d�fini �
<code>base64</code>, c'est un encodage de type base64 qui sera
effectu�. Au d�but d'un �l�ment
<code>echo</code>, la valeur par d�faut est d�finie �
<code>entity</code>, ce qui correspond � un codage de type entit�
(codage qui convient pour un �l�ment HTML de type bloc, comme le
paragraphe d'un texte). Cette valeur par d�faut peut �tre modifi�e
en ajoutant un attribut <code>encoding</code>, qui fera effet
jusqu'� la d�finition d'un nouvel attribut <code>encoding</code>
ou la fin de l'�l�ment echo.</p>
<p>Pour produire son effet, l'attribut <code>encoding</code> doit
pr�c�der l'attribut <code>var</code> concern�.</p>
<div class="warning">
Afin de pr�venir les attaques de type cross-site scripting, il
est recommand� de <em>toujours</em> encoder les donn�es fournies
par les utilisateurs.
</div>
<div class="example"><h3>Example</h3><p><code>
<!--#echo encoding="entity" var="QUERY_STRING" -->
</code></p></div>
</dd>
</dl>
<h3><a name="element.exec" id="element.exec">L'�l�ment exec</a></h3>
<p>La commande <code>exec</code> ex�cute la commande shell ou le
script sp�cifi�. Elle n�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�finie, cette commande est d�sactiv�e. Les attributs disponibles
sont :</p>
<dl>
<dt><code>cgi</code></dt>
<dd><p>La valeur sp�cifie un chemin URL vers le script CGI (encod�
avec caract�res %). Si le chemin ne commence pas par un slash (/),
il est consid�r� comme relatif au document courant. Le document
r�f�renc� par ce chemin est invoqu� en tant que script CGI, m�me
s'il n'est pas cens� �tre reconnu comme tel par le serveur. Les
scripts CGI doivent cependant �tre activ�s dans le r�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�ne d'arguments
(<code>QUERY_STRING</code>) de la requ�te originale du client sont
fournis au script CGI ; ils <em>ne peuvent pas</em> �tre sp�cifi�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>
<!--#exec cgi="/cgi-bin/exemple.cgi" -->
</code></p></div>
<p>Si, � la place d'un flux de sortie, le script renvoie un
en-t�te <code>Location:</code>, ce dernier sera traduit en ancrage
HTML.</p>
<p>L'�l�ment <code><a href="#includevirtual">include
virtual</a></code> doit �tre pr�f�r� � <code>exec cgi</code>. En
particulier, si vous devez transmettre des arguments
suppl�mentaires � un programme CGI en utilisant la cha�ne
d'arguments de la requ�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>
<!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
</code></p></div>
</dd>
<dt><code>cmd</code></dt>
<dd><p>Le serveur va ex�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�f�rable d'utiliser <code><a href="#includevirtual">#include virtual</a></code> � la place de
<code>#exec cgi</code> ou <code>#exec cmd</code>. <code>#include
virtual</code> utilise le m�canisme standard des sous-requ�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 � une commande dans une
directive <code>exec</code>, � moins d'ins�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�sir� sous Win32, ou dans le cas de l'utilisation de suexec
:</p>
<div class="example"><p><code>
<!--#exec cmd="perl /chemin/vers/script_perl arg1 arg2" -->
</code></p></div>
</dd>
</dl>
<h3><a name="element.fsize" id="element.fsize">L'�l�ment fsize</a></h3>
<p>Cette commande permet d'afficher la taille du fichier sp�cifi�
en fonction des sp�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�pertoire
contenant le document en cours d'interpr�tation.
<div class="example"><p><code>
Ce fichier a une taille de <!--#fsize file="mod_include.html"
--> octets.
</code></p></div>
La valeur de <code>file</code> ne peut pas faire r�f�rence � un
fichier situ� � un niveau sup�rieur de l'arborescence du r�pertoire
courant ou en dehors de la racine des documents ; il ne peut donc
ni commencer par un slash, ni contenir la s�quence de caract�res
<code>../</code>. Si c'est le cas, le message d'erreur <code>The
given path was above the root path</code> sera renvoy�.
</dd>
<dt><code>virtual</code></dt>
<dd>La valeur est un chemin URL (cod� avec caract�res %). S'il ne
commence pas par un slash (/), il est consid�r� 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�me.</dd>
</dl>
<div class="example"><p><code>
Ce fichier a une taille de <!--#fsize
virtual="/docs/mod/mod_include.html" --> 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><a name="element.flastmod" id="element.flastmod">L'�l�ment flastmod</a></h3>
<p>Cette commande permet d'afficher la date de derni�re
modification du fichier sp�cifi�, en fonction des sp�cifications
de format de <code>timefmt</code>. Les attributs sont les m�mes
que ceux de la commande <code><a href="#element.fsize">fsize</a></code>.</p>
<h3><a name="element.include" id="element.include">L'�l�ment include</a></h3>
<p>Cette commande permet d'ins�rer le texte d'un autre document ou
fichier dans le fichier en cours d'interpr�tation. Tout fichier
inclus est soumis au contr�le d'acc�s habituel. Si <a href="core.html#options">Options</a> <code>IncludesNOEXEC</code>
est d�fini pour le r�pertoire contenant le fichier
interpr�t�, seuls les documents poss�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 � eux, sont invoqu�s de mani�re
habituelle en utilisant l'URL compl�te fournie avec la commande, y
compris toute cha�ne d'arguments �ventuelle.</p>
<p>Un attribut d�finit le chemin du document � inclure, et peut
appara�tre plusieurs fois dans l'�l�ment � inclure ; en retour, pour
chaque attribut fourni � la commande include, une inclusion est
effectu�e. Les attributs disponibles sont :</p>
<dl>
<dt><code>file</code></dt>
<dd>La valeur est un chemin relatif au r�pertoire contenant le
fichier en cours d'interpr�tation. Elle ne peut ni contenir
<code>../</code>, ni �tre un chemin absolu. Ainsi, vous ne pouvez
pas inclure de fichiers situ�s en dehors de l'arborescence du
site web ou dans un niveau sup�rieur � celui du fichier courant
dans cette arborescence. Il est toujours pr�f�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� avec caract�res %). L'URL
ne peut contenir qu'un chemin et une cha�ne d'arguments
�ventuelle, � l'exclusion de tout protocole ou nom d'h�te. S'il ne
commence pas par un slash (/), il est consid�r� comme relatif au
document courant.</p>
<p>Une URL est construite � partir de l'attribut, et la sortie que
renverrait le serveur si l'URL �tait acc�d�e par le client est
incluse dans la sortie interpr�t�e. Les inclusions de fichiers
peuvent ainsi �tre imbriqu�es.</p>
<p>Si l'URL sp�cifi�e correspond � un programme CGI, le programme
sera ex�cut�, et son flux de sortie ins�r� � la place de la
directive dans le fichier interpr�t�. Vous pouvez ins�rer une
cha�ne d'arguments dans une URL correspond � un programme CGI
:</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
</code></p></div>
<p><code>include virtual</code> doit �tre pr�f�r� � <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�finie et valide pour le fichier inclus, les tentatives de
requ�tes POST vers le document HTML qui inclut des fichiers seront
transmises aux sous-requ�tes en tant que requ�tes POST
elles-m�mes. Sans cette directive, toutes les sous-requ�tes sont
trait�es en tant que requ�tes GET.</p>
</dd>
<dt><code>onerror</code></dt>
<dd><p>La valeur est un chemin-URL (cod�-%) qui est affich� si une
tentative pr�c�dente d'inclure un fichier ou un attribut virtuel a
�chou�. Pour produire son effet, cet attribut doit �tre sp�cifi�
apr�s le fichier ou les attributs virtuels concern�s. Si la
tentative d'inclure le chemin onerror �choue, ou si onerror n'est
pas sp�cifi�, c'est le message d'erreur par d�faut qui sera
inclus.</p>
<div class="example"><p><code>
# Exemple simple<br />
<!--#include virtual="/not-exist.html" onerror="/error.html" -->
</code></p></div>
<div class="example"><p><code>
# Chemins onerror d�di�s<br />
<!--#include virtual="/path-a.html" onerror="/error-a.html" virtual="/path-b.html" onerror="/error-b.html" -->
</code></p></div>
</dd>
</dl>
<h3><a name="element.printenv" id="element.printenv">L'�l�ment printenv</a></h3>
<p>Cette commande affiche la liste en mode texte de toutes les variables et de
leurs valeurs. Les caract�res sp�ciaux sont encod�s <code>entity</code> avant
d'�tre affich�s (se reporter � l'�l�ment <code><a href="#element.echo">echo</a></code> pour plus de d�tails). Cette
commande ne comporte pas d'attributs.</p>
<div class="example"><h3>Exemple</h3><p><code>
<pre>
<!--#printenv -->
</pre>
</code></p></div>
<h3><a name="element.set" id="element.set">L'�l�ment set</a></h3>
<p>Cette commande permet de d�finir la valeur d'une variable. Les
attributs sont :</p>
<dl>
<dt><code>var</code></dt>
<dd>Le nom de la variable � d�finir.</dd>
<dt><code>value</code></dt>
<dd>La valeur � affecter � la variable.</dd>
<dt><code>decoding</code></dt>
<dd><p>Sp�cifie si Apache doit effectuer un d�codage dans la
variable avant son traitement ult�rieur. La valeur par d�faut est
<code>none</code>, et dans ce cas, aucun d�codage n'est effectu�.
Si la valeur est <code>url</code>, <code>urlencoded</code>,
<code>base64</code> ou
<code>entity</code>, c'est un d�codage de type URL,
application/x-www-form-urlencoded, base64 ou
entit� HTML qui sera respectivement effectu�. Il est possible
d'effectuer plusieurs d�codages en
sp�cifiant plusieurs valeurs s�par�es par des virgules. Les
sp�cifications de d�codages restent valables jusqu'au prochain
attribut de d�codage, ou la fin de l'�l�ment. Pour �tre pris en
compte, l'attribut de <code>d�codage</code>
doit <em>pr�c�der</em> l'attribut <code>var</code> correspondant.</p>
</dd>
<dt><code>encoding</code></dt>
<dd><p>Sp�cifie la mani�re dont Apache va encoder les caract�res
sp�ciaux que la variable contient avant leur affichage. S'il est
d�fini � <code>none</code>, aucun encodage ne sera effectu�. 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� HTML qui sera respectivement effectu�. Il est possible de
sp�cifier plusieurs types d'encodage en les s�parant par des
virgules. La sp�cification du type d'encodage fera effet
jusqu'� la d�finition d'un nouvel attribut encoding
ou la fin de l'�l�ment. Pour produire son effet, l'attribut <code>encoding</code> doit
pr�c�der l'attribut <code>var</code> concern�. Les encodages sont
effectu�s apr�s les op�rations de d�codage.</p>
</dd>
</dl>
<div class="example"><h3>Exemple</h3><p><code>
<!--#set var="category" value="help" -->
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="includevars" id="includevars">Variables include</a></h2>
<p>� l'instar des variables de l'environnement CGI standard, ces
variables sont mises � la disposition de la commande
<code>echo</code>, des op�rateurs conditionnels <code>if</code> et
<code>elif</code>, et de tout programme invoqu� 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_NAME</code></dt>
<dd>Le nom de base du fichier demand� par l'utilisateur (sans son
chemin).</dd>
<dt><code>DOCUMENT_URI</code></dt>
<dd>Le chemin URL (caract�res % d�cod�s) du document demand� par
l'utilisateur. Notez que dans le cas d'inclusions de fichiers
imbriqu�es, il ne s'agit <em>pas</em> de l'URL du document
courant. Notez �galement que si l'URL est modifi�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�e
que contiendra la variable.</dd>
<dt><code>LAST_MODIFIED</code></dt>
<dd>La date de derni�re modification du document demand� par
l'utilisateur.</dd>
<dt><code>QUERY_STRING_UNESCAPED</code></dt>
<dd>Si une cha�ne d'arguments est pr�sente, elle sera affect�e �
cette variable, les caract�res % d�cod�s, et �ventuellement
<em>�chapp�s</em> pour qu'ils ne soient pas interpr�t�s par le
shell (les caract�res sp�ciaux comme <code>&</code>,etc...
sont pr�c�d�s d'anti-slashes).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="substitution" id="substitution">Substitution de variable</a></h2>
<p>Une substitution de variable � l'int�rieur d'une cha�ne entre
guillemets s'effectue dans la plupart des situations o� cette
derni�re peut raisonablement constituer un argument d'une directive
SSI. Sont concern�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�finie �
<code>on</code>, la substitution s'effectue aussi dans les arguments
des op�rateurs conditionnels. Vous pouvez ins�rer
un signe dollar en tant que caract�re litt�ral dans une cha�ne en
utilisant un anti-slash :</p>
<div class="example"><p><code>
<!--#set var="cur" value="\$test" -->
</code></p></div>
<p>Si une r�f�rence de variable doit �tre substitu�e au beau milieu
d'une s�quence de caract�res qui pourrait �tre elle-m�me consid�r�e
comme un identifiant valide, l'ambigu�t� peut �tre lev�e en
entourant la r�f�rence d'accolades, � la mani�re du shell :</p>
<div class="example"><p><code>
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
</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><a name="flowctrl" id="flowctrl">El�ments de contr�le d'inclusion conditionnelle</a></h2>
<p>Les �l�ments de base du contr�le d'inclusion conditionnelle sont
:</p>
<div class="example"><p><code>
<!--#if expr="<var>test_condition</var>" --><br />
<!--#elif expr="<var>test_condition</var>" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p>L'�l�ment <code>if</code> fonctionne de la m�me mani�re que
la directive if d'un langage de programmation. La condition est
�valu�e et si le r�sultat est vrai, le texte qui suit jusqu'au
prochain �l�ment <code>elif</code>, <code>else</code> ou
<code>endif</code> sera inclus dans le flux de sortie.</p>
<p>Les �l�ments <code>elif</code> ou <code>else</code> permettent
d'ins�rer du texte dans le flux de sortie si
<var>test_condition</var> s'est r�v�l� faux. Ces �l�ments sont
optionnels.</p>
<p>L'�l�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�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'�l�ment <code>var</code> sont
export�es vers l'environnement de la requ�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�seau local" sera affich� si
l'adresse IP du client appartient au sous-r�seau 10.0.0.0/8.</p>
<div class="example"><p><code>
<!--#if expr='-R "10.0.0.0/8"' --><br />
<span class="indent">
depuis le r�seau local<br />
</span>
<!--#else --><br />
<span class="indent">
depuis ailleurs<br />
</span>
<!--#endif -->
</code></p></div>
<p>Dans l'exemple suivant, "foo vaut bar" sera affich� si la variable
<code>foo</code> contient la valeur "bar".</p>
<div class="example"><p><code>
<!--#if expr='v("foo") = "bar"' --><br />
<span class="indent">
foo vaut bar<br />
</span>
<!--#endif -->
</code></p></div>
<div class="note"><h3>Documentation de r�f�rence</h3>
<p>Voir aussi <a href="../expr.html">Les expressions dans le serveur
HTTP Apache</a> pour une r�f�rence compl�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><a name="legacyexpr" id="legacyexpr">Syntaxe des expressions h�rit�e</a></h2>
<p>Cette section d�crit la syntaxe de l'�l�ment <code>#if
expr</code> dans le cas o� la directive <code class="directive"><a href="#ssilegacyexprparser">SSILegacyExprParser</a></code> est d�finie �
<code>on</code>.</p>
<dl>
<dt><code><var>cha�ne</var></code></dt>
<dd>vrai si <var>cha�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�ne est accessible du
point de vue de la configuration, faux sinon. Il
s'av�re utile lorsqu'un lien vers une URL doit �tre cach� aux
utilisateurs qui ne sont pas autoris�s � voir cette URL. Notez que
le test porte sur l'autorisation d'acc�s � l'URL, et non sur son
existence.</p>
<div class="example"><h3>Exemple</h3><p><code>
<!--#if expr="-A /prive" --><br />
<span class="indent">
Cliquez <a href="/prive">ici</a> pour acc�der aux
informations priv�es.<br />
</span>
<!--#endif -->
</code></p></div>
</dd>
<dt><code><var>cha�ne1</var> = <var>cha�ne2</var><br />
<var>cha�ne1</var> == <var>cha�ne2</var><br />
<var>cha�ne1</var> != <var>cha�ne2</var></code></dt>
<dd><p>Compare <var>cha�ne1</var> � <var>cha�ne2</var>. Si
<var>cha�ne2</var> est de la forme
<code>/<var>cha�ne2</var>/</code>, elle est trait�e comme une
expression rationnelle. Les expressions rationnelles sont
impl�ment�es par le moteur <a href="http://www.pcre.org">PCRE</a>
et poss�dent la m�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�me mani�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�es dans les
variables sp�ciales <code>$1</code> .. <code>$9</code>. L'ensemble
de la cha�ne correspondant � l'expression rationnelle est stock�
dans la variable sp�ciale <code>$0</code>.</p>
<div class="example"><h3>Exemple</h3><p><code>
<!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" --><br />
<span class="indent">
<!--#set var="session" value="$1" --><br />
</span>
<!--#endif -->
</code></p></div>
</dd>
<dt><code><var>cha�ne1</var> < <var>cha�ne2</var><br />
<var>cha�ne1</var> <= <var>cha�ne2</var><br />
<var>cha�ne1</var> > <var>cha�ne2</var><br />
<var>cha�ne1</var> >= <var>cha�ne2</var></code></dt>
<dd>Compare <var>cha�ne1</var> � <var>cha�ne2</var>. Notez que les
cha�nes sont compar�es de mani�re <em>litt�rale</em> (en utilisant
<code>strcmp(3)</code>). Ainsi, la cha�ne "100" est inf�rieure �
"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> &&
<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� sup�rieure
� "<code>&&</code>" et "<code>||</code>". "<code>!</code>" a
la priorit� la plus haute. Ainsi, les deux directives suivantes sont
�quivalentes :</p>
<div class="example"><p><code>
<!--#if expr="$a = test1 && $b = test2" --><br />
<!--#if expr="($a = test1) && ($b = test2)" -->
</code></p></div>
<p>Les op�rateurs bool�ens <code>&&</code> et
<code>||</code> ont la m�me priorit�. Ainsi, si vous voulez
augmenter la priorit� d'un de ces op�rateurs, vous devez utiliser
des parenth�ses.</p>
<p>Tout ce qui n'est pas reconnu comme variable ou op�rateur est
trait� comme une cha�ne. Les cha�nes peuvent aussi �tre entour�es
d'apostrophes : <code>'cha�ne'</code>. Les cha�nes sans apostrophe
ne peuvent pas contenir d'espaces (espaces ou tabulations) car
ceux-ci servent � s�parer certains �l�ments comme les variables. Si
plusieurs cha�nes se trouvent dans une ligne, elles sont concat�n�es
en utilisant des espaces. Ainsi,</p>
<div class="example"><p><code><var>cha�ne1</var> <var>cha�ne2</var></code> devient <code><var>cha�ne1</var> <var>cha�ne2</var></code><br />
<br />
et<br />
<br />
<code>'<var>cha�ne1</var> <var>cha�ne2</var>'</code> devient <code><var>cha�ne1</var> <var>cha�ne2</var></code>.</p></div>
<div class="note"><h3>Optimisation des expressions bool�ennes</h3>
<p>Si les expressions atteignent une complexit� suffisante pour
ralentir les traitements de mani�re significative, vous pouvez
essayer de les optimiser en fonction des r�gles d'�valuation :</p>
<ul>
<li>Les expressions sont �valu�es de la gauche vers la droite</li>
<li>Les op�rateurs bool�ens binaires (<code>&&</code> et
<code>||</code>) font l'objet d'une �valuation abr�g�e chaque fois
que cela est possible. En d'autres termes, et selon la r�gle
ci-dessus, <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> �value tout d'abord la
partie gauche de l'expression. Si le r�sultat de l'�valuation de
cette partie gauche suffit � d�terminer le r�sultat final,
l'�valuation s'arr�te ici. Dans le cas contraire, la partie droite
est �valu�e, et le r�sultat final tient compte des r�sultats des
�valuations des parties gauche et droite.</li>
<li>L'�valuation abr�g�e est d�sactiv�e tant qu'il reste des
expressions r�guli�res � traiter. Ces derni�res doivent �tre
�valu�es afin de d�finir les variables correspondant aux
r�f�rences arri�res (<code>$1</code> .. <code>$9</code>).</li>
</ul>
<p>Si vous voulez d�terminer la mani�re dont une expression est
trait�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�rer, pour chaque expression interpr�t�e,
des informations �tiquet�es, l'arbre d'interpr�tation et la
mani�re dont elle est �valu�e au sein du flux de sortie envoy� au
client.</p>
</div>
<div class="note"><h3>Slashes d'�chappement dans les expressions
rationnelles</h3>
<p>Tous les caract�res slashes qui ne sont pas des s�parateurs dans
votre expression rationnelle doivent �tre �chapp�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�f�rence</h3>
<p>Voir le document <a href="../expr.html">Les expressions dans le
serveur HTTP Apache</a>, pour une r�f�rence compl�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><a name="ssiendtag" id="ssiendtag">Directive</a> <a name="SSIEndTag" id="SSIEndTag">SSIEndTag</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha�ne qui termine l'�l�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�faut:</a></th><td><code>SSIEndTag "-->"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, 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�ne que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interpr�te comme la fin d'un �l�ment
include.</p>
<pre class="prettyprint lang-config">SSIEndTag "%>"</pre>
<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><a name="ssierrormsg" id="ssierrormsg">Directive</a> <a name="SSIErrorMsg" id="SSIErrorMsg">SSIErrorMsg</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Message d'erreur affich� 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�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 du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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� lorsqu'une erreur SSI survient.
Pour les serveurs en production, il est recommand� de modifier le
message d'erreur par d�faut en <code>"<!-- Error
-->"</code>, de fa�on � ce que le message ne soit pas
pr�sent� � l'utilisateur.</p>
<p>Cette directive a le m�me effet que l'�l�ment
<code><!--#config errmsg=<var>message</var> --></code>.</p>
<pre class="prettyprint lang-config">SSIErrorMsg "<!-- Error -->"</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ssietag" id="ssietag">Directive</a> <a name="SSIETag" id="SSIETag">SSIETag</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit si des en-t�tes ETags sont g�n�r�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�faut:</a></th><td><code>SSIETag off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</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�:</a></th><td>Disponible � partir de la version 2.2.15 du serveur HTTP
Apache.</td></tr>
</table>
<p>Dans le cas g�n�ral, un fichier filtr� par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des �l�ments soit
g�n�r�s dynamiquement, soit �ventuellement modifi�s ind�pendemment
du fichier original. En cons�quence, il est demand� par d�faut au
serveur de ne pas g�n�rer d'en-t�te <code>ETag</code> � la r�ponse
en ajoutant <code>no-etag</code> aux informations de requ�te.</p>
<p>Ce comportement peut �tre modifi� via la directive
<code class="directive">SSIETag</code> qui permet au serveur de g�n�rer un
en-t�te <code>ETag</code>. On peut aussi l'utiliser pour la mise
en cache de la sortie. Notez qu'un serveur d'arri�re-plan ou un
g�n�rateur de contenu dynamique peut lui-m�me g�n�rer un en-t�te
<code>ETag</code>, en ignorant l'information <code>no-etag</code>,
cet en-t�te <code>ETag</code> �tant transmis par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sans tenir compte de la d�finition de
la pr�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� aux informations de
requ�te, et il sera demand� au serveur de ne pas g�n�rer
d'en-t�te <code>ETag</code>. Lorsqu'un serveur ignore la valeur
de <code>no-etag</code> et g�n�re tout de m�me un en-t�te
<code>ETag</code>, ce dernier sera respect�.</dd>
<dt><code>on</code></dt>
<dd>Les en-t�tes <code>ETag</code> existants seront respect�s,
et ceux g�n�r�s par le serveur seront ajout�s � la r�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><a name="ssilastmodified" id="ssilastmodified">Directive</a> <a name="SSILastModified" id="SSILastModified">SSILastModified</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit si des en-t�tes <code>Last-Modified</code> sont
g�n�r�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�faut:</a></th><td><code>SSILastModified off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</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�:</a></th><td>Disponible � partir de la version 2.2.15 du serveur HTTP
Apache.</td></tr>
</table>
<p>Dans le cas g�n�ral, un fichier filtr� par
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> peut contenir des �l�ments soit
g�n�r�s dynamiquement, soit �ventuellement modifi�s ind�pendemment
du fichier original. En cons�quence, l'en-t�te
<code>Last-Modified</code> est supprim� par d�faut de la r�ponse.</p>
<p>La directive <code class="directive">SSILastModified</code> permet de
modifier ce comportement en faisant en sorte que l'en-t�te
<code>Last-Modified</code> soit respect� s'il est d�j� pr�sent, ou
d�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�te <code>Last-Modified</code> sera supprim� des
r�ponses, � moins que la directive <code class="directive"><a href="#xbithack">XBitHack</a></code> ne soit d�finie �
<code>full</code> comme d�crit plus loin.</dd>
<dt><code>on</code></dt>
<dd>L'en-t�te <code>Last-Modified</code> sera respect� s'il est
d�j� pr�sent, et ajout� � la r�ponse si cette derni�re est un
fichier et si l'en-t�te est manquant. La directive <code class="directive"><a href="#ssilastmodified">SSILastModified</a></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><a name="ssilegacyexprparser" id="ssilegacyexprparser">Directive</a> <a name="SSILegacyExprParser" id="SSILegacyExprParser">SSILegacyExprParser</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le mode de compatibilit� 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�faut:</a></th><td><code>SSILegacyExprParser off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</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�:</a></th><td>Disponible � 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�
la nouvelle syntaxe <a href="../expr.html">ap_expr</a> pour ses
expressions conditionnelles dans les �l�ments de contr�le de flux
<code>#if</code>. Cette directive permet de r�activer l'<a href="#legacyexpr">ancienne syntaxe</a> qui est compatible avec les
versions 2.2.x et ant�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><a name="ssistarttag" id="ssistarttag">Directive</a> <a name="SSIStartTag" id="SSIStartTag">SSIStartTag</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha�ne qui marque le d�but d'un �l�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�faut:</a></th><td><code>SSIStartTag "<!--#"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, 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�ne que
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> interpr�te comme le d�but d'un �l�ment
include.</p>
<p>Cette option peut vous �tre utile si vous avez deux serveurs qui
interpr�tent un fichier avec des commandes diff�rentes (et
�ventuellement � des moments diff�rents).</p>
<pre class="prettyprint lang-config"> SSIStartTag "<%"<br />
SSIEndTag "%>"</pre>
<p>Avec l'exemple ci-dessus, qui d�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�but et de fin
personnalis�es</h3><p><code>
<%printenv %>
</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><a name="ssitimeformat" id="ssitimeformat">Directive</a> <a name="SSITimeFormat" id="SSITimeFormat">SSITimeFormat</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�ne de formatage</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�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 du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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�ne de
formatage</var> est identique � celle de la fonction
<code>strftime(3)</code> de la biblioth�que C standard.</p>
<p>Cette directive a le m�me effet que l'�l�ment
<code><!--#config timefmt=<var>cha�ne de formatage</var>
--></code>.</p>
<pre class="prettyprint lang-config">SSITimeFormat "%R, %B %d, %Y"</pre>
<p>Avec l'exemple ci-dessus, les dates seront affich�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><a name="ssiundefinedecho" id="ssiundefinedecho">Directive</a> <a name="SSIUndefinedEcho" id="SSIUndefinedEcho">SSIUndefinedEcho</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Cha�ne � afficher lorsqu'on tente d'extraire le contenu
d'une variable non d�finie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SSIUndefinedEcho <var>cha�ne</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>SSIUndefinedEcho "(none)"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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�ne affich�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�finie.</p>
<pre class="prettyprint lang-config">SSIUndefinedEcho "<!-- nondef -->"</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="xbithack" id="xbithack">Directive</a> <a name="XBitHack" id="XBitHack">XBitHack</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interpr�te les directives SSI dans les fichiers dont le bit
d'ex�cution est positionn�</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�faut:</a></th><td><code>XBitHack off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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�ler
l'interpr�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�cutables.</dd>
<dt><code>on</code></dt>
<dd>Tout fichier <code>text/html</code> dont le bit d'ex�cution
est positionn� pour le propri�taire sera trait� en tant que
document html interpr�t� par le serveur.</dd>
<dt><code>full</code></dt>
<dd>Identique � <code>on</code>, avec test du bit d'ex�cution pour
le groupe. Si ce dernier est positionn�, la date de <code>derni�re
modification</code> du fichier renvoy� est d�finie � la date de
derni�re modification du fichier. Dans le cas contraire, aucune
date de derni�re modification n'est renvoy�e. Le positionnement de
ce bit permet aux clients et aux mandataires de g�rer la mise en
cache du r�sultat de la requ�te.
<div class="note"><h3>Note</h3>
<p>Il est recommand� de n'utiliser l'option full que dans le cas
o� vous �tes certain que le bit d'ex�cution du groupe est non
positionn� pour les scripts SSI qui pourraient effectuer l'<code>#include</code> d'un programme CGI ou bien produire des sorties
diff�rentes � chaque acc�s (ou seraient susceptibles d'�tre
modifi�es au cours des requ�tes ult�rieures).</p>
<p>Lorsqu'elle est d�finie � <code>on</code>, la directive
<code class="directive"><a href="#ssilastmodified">SSILastModified</a></code>
l'emporte sur la directive <code class="directive"><a href="#xbithack">XBitHack</a></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"> en </a> |
<a href="../fr/mod/mod_include.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/mod_include.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_include.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autoris� sous <a href="http://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/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>